Upgrade to Pro — share decks privately, control downloads, hide ads and more …

gradle-best-practices 使ってみた

Sponsored · Ship Features Fearlessly Turn features on and off without deploys. Used by thousands of Ruby developers. →
mikan
November 17, 2026

gradle-best-practices 使ってみた

mikan

November 17, 2026

Transcript

30 slides
  1. 自己紹介 Speaker object Mikan { val name = "一瀬喜弘" val

    occupation = Engineer.Android val company = "AbemaTV" val favoriteBooks = listOf( "ソフトウェア設計の結合バランス", ) } X @mikanIchinose GitHub @mikanIchinose 02 / 30
  2. 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
  3. 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
  4. 優先順位 Background チームが四半期に回せる大きな案件は約 3 つ Declarative Gradle 1 Configuration Cache

    Isolated Projects Agentic Gradle のデフォルト化を Gradle 10 → 11 に延期してまで枠を確保した 06 / 30
  5. 公式スキルの提供 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
  6. タスクアクション外で Provider.get() を呼ばない 採用 3/6 dependencies { - add("implementation", libs.kotlinx.coroutines.get())

    + add("implementation", libs.kotlinx.coroutines) } 構成フェーズで get() すると値がその場で確定し、遅延評価が効かない DependencyHandler.add は Provider をそのまま受け取れる 14 / 30
  7. 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
  8. タスク実行中に 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
  9. 他プラグインの適用順を前提にしない 不採用 1/3 自作の convention plugin が、AGP や KMP が先に適用されている前提で設定を触っていた

    -extensions.configure<CommonExtension> { ... } +pluginManager.withPlugin("com.android.library") { + extensions.configure<CommonExtension> { ... } +} 1 指摘箇所は、リファクタリングで今後使われなくなるものだった 2 将来消えるので、直さずに放置した 19 / 30
  10. 意図しない空プロジェクトを作らない 不採用 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
  11. Lazy API を意識する 1 Provider / Property 2 get() Practice

    1/3 で値ではなく、値の計算方法を渡す を呼ぶのはタスク実行時だけ 23 / 30
  12. 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
  13. 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
  14. もっと詳しく 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
  15. 適用は各モジュールで明示的に 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

More Decks by mikan

Other Decks in Technology