Upgrade to Pro
— share decks privately, control downloads, hide ads and more …
Speaker Deck
Features
Speaker Deck
PRO
Sign in
Sign up for free
Search
Search
Kotlin Contribution Guide
Search
kobito-kaba
December 06, 2017
Programming
1
270
Kotlin Contribution Guide
Kotlinへのコントリビューションを2パターン例に上げて、どんな感じでやるのか説明します。
kobito-kaba
December 06, 2017
Tweet
Share
More Decks by kobito-kaba
See All by kobito-kaba
新規プロジェクトでやってよかったことまとめ
kobitokaba
1
720
Youtube like BottomNavigation
kobitokaba
0
180
Modularizing and Refactoring Android App with Clean Architecture
kobitokaba
0
210
Slice Your App
kobitokaba
2
1.1k
Inside Jetpack
kobitokaba
2
92
Generating and Transforming Kotlin code
kobitokaba
0
64
Conference Tourism
kobitokaba
0
230
Inside Jetpack Architecture Components
kobitokaba
0
190
Kotlinもう一歩
kobitokaba
8
15k
Other Decks in Programming
See All in Programming
ポケモンで考えるコミュニケーション / Communication Lessons from Pokémon
mackey0225
4
170
"noncopyable types" の使いどころについて考えてみた
andpad
0
160
The Myth of the Modular Monolith - Day 2 Keynote - Rails World 2024
eileencodes
10
1.4k
[KR] Server Driven Compose With Firebase
skydoves
2
200
型付きで行うVSCode拡張機能開発 / VSCode Meetup #31
mazrean
0
240
CSC509 Lecture 04
javiergs
PRO
0
150
Jakarta EE as Seen Trough the Lens of the ASF
ivargrimstad
0
180
2024-10-02 dev2next - Application Observability like you've never heard before
jonatan_ivanov
0
180
The Efficiency Paradox and How to Save Yourself and the World
hollycummins
0
180
CSC509 Lecture 03
javiergs
PRO
0
140
4年間変わらなかった YOUTRUSTのアーキテクチャ
daiki1003
1
630
データサイエンスのフルサイクル開発を実現する機械学習パイプライン
xcnkx
2
500
Featured
See All Featured
Designing for humans not robots
tammielis
249
25k
BBQ
matthewcrist
85
9.2k
Building Your Own Lightsaber
phodgson
102
6k
How STYLIGHT went responsive
nonsquared
95
5.1k
How GitHub (no longer) Works
holman
311
140k
ReactJS: Keep Simple. Everything can be a component!
pedronauck
664
120k
A Philosophy of Restraint
colly
203
16k
A Tale of Four Properties
chriscoyier
156
22k
Building Flexible Design Systems
yeseniaperezcruz
327
38k
The Straight Up "How To Draw Better" Workshop
denniskardys
232
130k
Design and Strategy: How to Deal with People Who Don’t "Get" Design
morganepeng
126
18k
Art, The Web, and Tiny UX
lynnandtonic
296
20k
Transcript
Kotlin Contributing Guide 森 洋之(ヤフー株式会社) GDG神戸 Android Oreo with Kotlin&Android Studio
3.0勉強会
今日話すこと ・Kotlinが公式になったし ・この機会にContributeしてみませんか ・かんたんだよ!
Kotlin、公式の開発言語になりました ・ふじゅうぶんな ・Java8対応を待つよりも ・Kotlinをつかったほうが ・ずっと快適
各地のセミナーで大人気の話題です
せっかくなので、Contributeしてみませんか
Oh, OK daddy! 写真:アフロ
But, How... 写真:アフロ
開発環境のセットアップ
開発環境のセットアップ ※開発環境のセットアップについては、 すべてREADMEに書いてあります JetBrains/kotlin
必要なもの ・JDK JDKの1.6, 1.7, 1.8がすべて必要です。 JDK 1.6 for Mac for Others(要ログイン) JDK
1.7 Oracle(要ログイン) JDK 1.8 Oracle ・IntelliJ IDEA Community Editionで大丈夫 IntelliJ IDEA ・Apache Ant 1.9.4〜(たぶんもう入ってる)Apache Ant Project
JDK 1.6〜1.8 環境変数も設定します JAVA_HOME="path to JDK 1.8" JDK_16="path to JDK
1.6" JDK_17="path to JDK 1.7" JDK_18="path to JDK 1.8" java_homeコマンドを使うと楽です JAVA_HOME = `/usr/libexec/java_home -v 1.8`
fork, clone わりと時間かかります JetBrains/kotlin
dependenciesの更新 わりと時間かかります ant -f update_dependencies.xml ant -f build.xml
IntelliJで開く IntelliJ IDEAのプロジェクト用ファイルが含まれているので、 そのまま開くことができます。
Kotlin pluginのインストール 最新のKotlin pluginをインストールする
Project Structureの設定 Project SDKの設定、 SDKsにJDK 1.6, 1.7, 1.8を追加
Run! ビルドしたKotlin Pluginの入ったIntelliJ IDEAが起動するので、いろいろ試せる。
Contributing
issueを修正する ・issueはYouTrackで管理されているので、ここから未解決のものを探して修正するのが早い ・すぐに修正されるので、手を挙げてから始めたほうが、悲しい思いをしないで済むかも ・新規featureの提案も歓迎されるけど、 mergeには時間かかると思う
試しに2つ、issueを見てみましょう ・KT-20023 Java to Kotlin変換に関するbug ・KT-17204 Quickfixを追加してほしいfeature
Ok, Let’s try! 写真:アフロ
概要 @Nonnull(when = When.ALWAYS) @TypeQualifierDefault(ElementType.TYPE_USE) public @interface MaybeTypeuse { }
↑このJavaコードをktファイルにコピペしたら、 ↓こうなる @TypeQualifierDefault(ElementType.TYPE_USE) annotation class MaybeTypeuse この場合の@Nonnullは意味があるやつなので、消すべきじゃない KT-20023
概要 ・Java to Kotlin変換の関連ファイルは、j2kフォルダ内にある ・テストは、testDataフォルダ内に 変換前のJavaコード、変換後のKotlinコードを置いて、 生成する KT-20023
KT-20023 まずテスト j2k/testData/fileOrElement/issues/ before kt-20023.java after kt-20023.kt 変換前Javaコード 変換後Kotlinコード
KT-20023 kt-20023.java kt-20023.kt Before After これが、こう変換されること、という内容のテストになる
KT-20023 ・run “Generate Tests” ・テストコードが生成されます ・run “J2K Tests”で実行されます
KT-20023 実装 ・Java to Kotlin変換の関連ファイルは、j2kフォルダ内にある ・JavaToKotlinConverter#elementsToKotlin() ・Converter#convert() あたりを探る ・デバッグも使えるから、楽に探れます
KT-20023 JavaToKotlinConverter#elementsToKotlin() 中間生成物を作って 結果をまとめる
KT-20023 Converter#convert() ※コピペするか、ファイル単位で変換するかで、途中経過が違う
KT-20023 Converter#convert()
KT-20023 AnnotationConverter#convertAnnotations() 特定のアノテーションを削除している
KT-20023 AnnotationConverter#convertAnnotations() 削除すべきアノテーションのなかにある
KT-20023 AnnotationConverter#convertAnnotations() アノテーション型の場合は削除しない ここを こうしてみる
KT-20023 Run!
Ok, Next! 写真:アフロ
KT-17204 概要 open class Plant{ var size:Int = 0 fun
grow(size :Int):Unit{ size += size //val cannot be reassigned } } ↑ こういう場合に、 this.size += sizeとするQuickFixほしい
KT-17204 概要 ・Kotlin pluginの関連ファイルは、ideaフォルダ内にある ・QuickFixに関するものは、src/org.jetbrains.kotlin.idea.quickfix ・テストは idea/testData/quickFixにQuickFixでの変換前後のKotlinコードを置いて、生成する
KT-17204 まずテスト idea/testData/quickFix/ before addThis/basic.kt after addThis/basic.kt.after 変換前 変換後
KT-17204 addThis/basic.kt addThis/basic.kt.after Before After これが、こう変換されること、という内容のテストになる
KT-17204 ・run “Generate Tests” ・テストコードが生成されます run “All IDEA Plugin Tests”
※すごい時間かかる
KT-17204 ・Kotlin pluginの関連ファイルは、ideaフォルダ内にある ・QuickFixに関するものは、src/org.jetbrains.kotlin.idea/quickfix 1. 必要なQuickFix用のクラスを作成 2. そのQuickFix作成用のファクトリクラスを作成 3. QuickFixRegister内で、対応するエラーに対して、ファクトリクラスを登録する
KT-17204 QuickFix用のクラス作成 KotlinQuickFixActionを継承する
KT-17204 QuickFix作成用のファクトリクラスを作成
KT-17204 QuickFixRegister内で、対応するエラーに対して、ファクトリクラスを登録する
KT-17204 Run!
Very easy! 写真:アフロ
〜おわり〜 写真:アフロ