Kotlin Contribution Guide

Kotlinへのコントリビューションを2パターン例に上げて、どんな感じでやるのか説明します。

Transcript

1. Kotlin Contributing Guide 森　洋之（ヤフー株式会社） GDG神戸 Android Oreo with Kotlin&Android Studio 3.0勉強会
2. 今日話すこと ・Kotlinが公式になったし ・この機会にContributeしてみませんか ・かんたんだよ！
3. Kotlin、公式の開発言語になりました ・ふじゅうぶんな ・Java8対応を待つよりも ・Kotlinをつかったほうが ・ずっと快適
4. 各地のセミナーで大人気の話題です
5. せっかくなので、Contributeしてみませんか
6. Oh, OK daddy! 写真：アフロ
7. But, How... 写真：アフロ
8. 開発環境のセットアップ
9. 開発環境のセットアップ ※開発環境のセットアップについては、 すべてREADMEに書いてあります JetBrains/kotlin
10. 必要なもの ・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
11. 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`
12. fork, clone わりと時間かかります JetBrains/kotlin
13. dependenciesの更新 わりと時間かかります ant -f update_dependencies.xml ant -f build.xml
14. IntelliJで開く IntelliJ IDEAのプロジェクト用ファイルが含まれているので、 そのまま開くことができます。
15. Kotlin pluginのインストール 最新のKotlin pluginをインストールする
16. Project Structureの設定 Project SDKの設定、 SDKsにJDK 1.6, 1.7, 1.8を追加
17. Run! ビルドしたKotlin Pluginの入ったIntelliJ IDEAが起動するので、いろいろ試せる。
18. Contributing
19. issueを修正する ・issueはYouTrackで管理されているので、ここから未解決のものを探して修正するのが早い ・すぐに修正されるので、手を挙げてから始めたほうが、悲しい思いをしないで済むかも ・新規featureの提案も歓迎されるけど、 mergeには時間かかると思う
20. 試しに2つ、issueを見てみましょう ・KT-20023 Java to Kotlin変換に関するbug ・KT-17204 Quickfixを追加してほしいfeature
21. Ok, Let’s try! 写真：アフロ
22. 概要 @Nonnull(when = When.ALWAYS) @TypeQualifierDefault(ElementType.TYPE_USE) public @interface MaybeTypeuse { } ↑このJavaコードをktファイルにコピペしたら、 ↓こうなる @TypeQualifierDefault(ElementType.TYPE_USE) annotation class MaybeTypeuse この場合の@Nonnullは意味があるやつなので、消すべきじゃない KT-20023
23. 概要 ・Java to Kotlin変換の関連ファイルは、j2kフォルダ内にある ・テストは、testDataフォルダ内に 　変換前のJavaコード、変換後のKotlinコードを置いて、 　生成する KT-20023
24. KT-20023 まずテスト j2k/testData/fileOrElement/issues/ before　kt-20023.java after　　kt-20023.kt 変換前Javaコード 変換後Kotlinコード
25. KT-20023 kt-20023.java kt-20023.kt Before After これが、こう変換されること、という内容のテストになる
26. KT-20023 ・run “Generate Tests” ・テストコードが生成されます ・run “J2K Tests”で実行されます
27. KT-20023 実装 ・Java to Kotlin変換の関連ファイルは、j2kフォルダ内にある ・JavaToKotlinConverter#elementsToKotlin() ・Converter#convert() あたりを探る ・デバッグも使えるから、楽に探れます
28. KT-20023 JavaToKotlinConverter#elementsToKotlin() 中間生成物を作って 結果をまとめる
29. KT-20023 Converter#convert() ※コピペするか、ファイル単位で変換するかで、途中経過が違う
30. KT-20023 Converter#convert()
31. KT-20023 AnnotationConverter#convertAnnotations() 特定のアノテーションを削除している
32. KT-20023 AnnotationConverter#convertAnnotations() 削除すべきアノテーションのなかにある
33. KT-20023 AnnotationConverter#convertAnnotations() アノテーション型の場合は削除しない ここを こうしてみる
34. KT-20023 Run!
35. Ok, Next! 写真：アフロ
36. KT-17204 概要 open class Plant{ var size:Int = 0 fun grow(size :Int):Unit{ size += size //val cannot be reassigned } } ↑ こういう場合に、 this.size += sizeとするQuickFixほしい
37. KT-17204 概要 ・Kotlin pluginの関連ファイルは、ideaフォルダ内にある ・QuickFixに関するものは、src/org.jetbrains.kotlin.idea.quickfix ・テストは idea/testData/quickFixにQuickFixでの変換前後のKotlinコードを置いて、生成する
38. KT-17204 まずテスト idea/testData/quickFix/ before　addThis/basic.kt after　　addThis/basic.kt.after 変換前 変換後
39. KT-17204 addThis/basic.kt addThis/basic.kt.after Before After これが、こう変換されること、という内容のテストになる
40. KT-17204 ・run “Generate Tests” ・テストコードが生成されます run “All IDEA Plugin Tests” ※すごい時間かかる
41. KT-17204 ・Kotlin pluginの関連ファイルは、ideaフォルダ内にある ・QuickFixに関するものは、src/org.jetbrains.kotlin.idea/quickfix 1. 必要なQuickFix用のクラスを作成 2. そのQuickFix作成用のファクトリクラスを作成 3. QuickFixRegister内で、対応するエラーに対して、ファクトリクラスを登録する
42. KT-17204 QuickFix用のクラス作成 KotlinQuickFixActionを継承する
43. KT-17204 QuickFix作成用のファクトリクラスを作成
44. KT-17204 QuickFixRegister内で、対応するエラーに対して、ファクトリクラスを登録する
45. KT-17204 Run!
46. Very easy! 写真：アフロ
47. 〜おわり〜 写真：アフロ