Share
Embed
gradle-best-practices 使ってみた
mikan
November 17, 2026
Transcript
30 slides
-
CA.aab #7 / 2026.11.17 gradle-best-practices 使ってみた m mikan( 一瀬喜弘) 10
20 30 40 60 80 95 -
自己紹介 Speaker object Mikan { val name = "一瀬喜弘" val
occupation = Engineer.Android val company = "AbemaTV" val favoriteBooks = listOf( "ソフトウェア設計の結合バランス", ) } X @mikanIchinose GitHub @mikanIchinose 02 / 30 -
Gradle Is Going Agentic Background The agent is now part
of the build loop, whether the build tool invited it or not. エージェントがビルドを触る前提の方向に進んでいる 1 AI 2 ビルドツールエコシステムをエージェントに優しくする https://blog.gradle.org/gradle-is-going-agentic (2026-08-19) 04 / 30 -
Agentic Gradle 公式 Skills の 3 本柱 ビルドエラーの読み方、Build Scan の
読み方など ベンチマーク エージェントと Gradle のバージョンを 固定し、スキルや Gradle の変更だけを 比べる Background 摩擦の除去 エージェントに向かない挙動の修正、 ドキュメントの改善 We won’t ship one until we can show it makes an agent better at a real Gradle task. 05 / 30 -
優先順位 Background チームが四半期に回せる大きな案件は約 3 つ Declarative Gradle 1 Configuration Cache
Isolated Projects Agentic Gradle のデフォルト化を Gradle 10 → 11 に延期してまで枠を確保した 06 / 30 -
公式スキルの提供 1 gradle-skills: Claude Code 2 gradle-best-practices: Background などから使える Gradle
公式のスキル集 公式ベストプラクティスに沿ってビルドを監査し、修正案を出す https://github.com/gradle/gradle-skills /plugin marketplace add gradle/gradle-skills /plugin install gradle-skills@gradle-skills 07 / 30 -
詳しくみてみる Result 指摘ごとに 場所 問題 修正方法 公式ドキュメントへのリンク が出る 1 件ずつ採用する
/ しないに仕分けした 10 / 30 -
バージョン管理をカタログファイルに一元化 libs.versions.toml 採用 1/6 があるのに、直書きのバージョンが残っていた // KotlinMultiplatformAndroidPlugin.kt -implementation("junit:junit:4.13") +implementation(libs.junit) //
KotlinMultiplatformJvmPlugin.kt -implementation("junit:junit:4.13.2") +implementation(libs.junit) 同じ junit が 4.13 と 4.13.2 に分かれていた 12 / 30 -
依存の重複宣言を避ける 採用 2/6 dependencies { implementation(libs.androidx.lifecycle.viewmodel) ... - implementation(libs.androidx.lifecycle.viewmodel) }
同じブロックに同じ依存が 2 回書かれていた。10 件 片方を消すだけ 13 / 30 -
タスクアクション外で Provider.get() を呼ばない 採用 3/6 dependencies { - add("implementation", libs.kotlinx.coroutines.get())
+ add("implementation", libs.kotlinx.coroutines) } 構成フェーズで get() すると値がその場で確定し、遅延評価が効かない DependencyHandler.add は Provider をそのまま受け取れる 14 / 30 -
map の中で get しない 採用 4/6 reportMerge { - input.from(tasks.withType<Detekt>().map
{ it.xmlReportFile.get() }) + input.from(tasks.withType<Detekt>().map { it.xmlReportFile }) } の中で get() すると、Provider の連鎖がそこで切れる Provider のまま渡せば、タスク間の依存も Gradle が自動で張る map 15 / 30 -
タスク実行中に Project にアクセスしない 採用 5/6 +val playTrack = play.track tasks.register("showPlayConfig")
{ doLast { - println(play.track.get()) + println(playTrack.get()) // play は Project の拡張 } } 実行フェーズで Project を参照すると Configuration Cache と両立しない 必要な値は構成時に取り出しておき、アクションではそれを読む 16 / 30 -
dependsOn を避ける 採用 6/6 -tasks.named("embedAndSignAppleFrameworkForXcode") { - dependsOn("generateXCFileList") -} 成果物の受け渡しがない、ただの順序付けだった
そもそも Gradle でやる必要がなかったので、Xcode の Build Phase から直接呼ぶようにした 17 / 30 -
他プラグインの適用順を前提にしない 不採用 1/3 自作の convention plugin が、AGP や KMP が先に適用されている前提で設定を触っていた
-extensions.configure<CommonExtension> { ... } +pluginManager.withPlugin("com.android.library") { + extensions.configure<CommonExtension> { ... } +} 1 指摘箇所は、リファクタリングで今後使われなくなるものだった 2 将来消えるので、直さずに放置した 19 / 30 -
出力ファイル・ディレクトリを一意にする 不採用 2/3 あるコピー系タスクの出力先がプロジェクトディレクトリ全体になっていた -tasks.register<Copy>("updateXxx") { - into(project.layout.projectDirectory) -} +abstract
class UpdateXxx : DefaultTask() { + @get:OutputFile abstract val output: RegularFileProperty +} 1 直しても大した改善にならない 20 / 30 -
意図しない空プロジェクトを作らない 不採用 3/3 入れ子の include から、build script の無い中間プロジェクトが数十個できていた // settings.gradle.kts
-include(":feature:xxx:ui") // :feature と :feature:xxx も勝手にできる +include(":feature-xxx-ui") +project(":feature-xxx-ui").projectDir = file("feature/xxx/ui") 1 直してもビルド速度に影響がなかった 21 / 30 -
Lazy API を意識する 1 Provider / Property 2 get() Practice
1/3 で値ではなく、値の計算方法を渡す を呼ぶのはタスク実行時だけ 23 / 30 -
Provider: あとで値をくれるもの Lazy API 1/2 val version: Provider<String> = providers.gradleProperty("appVersion")
val tag: Provider<String> = version.map { "v$it" } tag.get() // まだ何も読まない // ここで初めて gradle.properties を読んで "v1.2.3" になる 1 値そのものではなく値の計算方法を持つ。読み取り専用 2 map / flatMap / zip で新しい Provider を作れる。 get() するまで計算されない 24 / 30 -
Property: 値を入れられる Provider Lazy API 2/2 abstract class Greet :
DefaultTask() { @get:Input abstract val message: Property<String> @TaskAction fun run() = println(message.get()) // 読むのは実行時 } tasks.register<Greet>("greet") { message.set(version.map { "v$it" }) // Provider をそのまま入れる } で値も Provider も入れられる。タスクの入出力はこれで宣言する 1 set() 2 ListProperty / RegularFileProperty / DirectoryProperty などの型ごとの版がある 25 / 30 -
もっと詳しく Lazy API DroidKaigi.collect { #30@Tokyo } / 2026.05.29 Lazy
API を使ってGradleビルド速度を改善する https://speakerdeck.com/mikanichinose/lazy-apiwoshi-tutegradlebirudosu-du-wogai-shan-suru で構成フェーズを短くする 1 tasks.register / configureEach 2 実行時に Project を触らず、Configuration Cache を効かせる 26 / 30 -
適用は各モジュールで明示的に Practice 2/3 // Before: ルートから全モジュールに一括で適用 subprojects { apply(plugin =
"com.android.library") } // After: 各モジュールで自分から宣言する plugins { id("myapp.android.library") } 1 一括で適用すると、モジュールを読んでも何が効いているか分からない。人間も AI も同じ 2 subprojects {} は gradle-best-practices が真っ先に指摘するパターンでもある 28 / 30