mcpField
A
agp-9-upgrade

agp-9-upgrade

github.com/android開発10.0k1.3k 回インストール2 日前に更新
リポジトリ

agp-9-upgrade について

Android プロジェクトを AGP 9 に移行するための手順を開発者向けに示すスキルです。互換性確認、依存関係や DSL の変更、ビルド検証を扱い、KMP プロジェクトは対象外です。

主な機能

  1. 01AGP とツールの互換性確認
  2. 02組み込み Kotlin と新 DSL への移行
  3. 03KSP、kapt、BuildConfig の更新
  4. 04不要な gradle.properties 設定の削除
  5. 05Gradle 同期とビルドの検証

活用シーン

  1. 01Android プロジェクトの AGP 9 への更新
  2. 02移行後の Gradle ビルド問題の調査

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/android/skills --skill agp-9-upgrade

インストール後、Claude Code で/agp-9-upgradeを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
buildconfig.md
ksp-kapt.md
paparazzi-gradle-9.md
recipes.md

詳細

移行ガイド

AGP 8 と比べた AGP 9 の主な変更点（多くは破壊的変更です）については、AGP 9 移行ガイドを参照してください。

要件

ユーザーから AGP 9 への更新または移行を依頼された場合は、まずプロジェクトで使用されている AGP のバージョンを確認してください。9 未満の場合は作業を中断し、Android Studio の AGP Upgrade Assistant を実行して AGP を最新の安定版に更新するようユーザーに依頼し、完了したことを確認してください。ユーザーからこの要件を省略するよう依頼される場合もあります。その場合は、AGP 9 への移行の一環として、AGP を最新の安定版に更新してください。更新方法については、AGP 9 移行ガイドを参照してください。

AGP の各バージョンには、Gradle、JDK、Kotlin など、他のツールとの互換性要件があります。それぞれのバージョンのリリースノートには、これらのツールの最小バージョンを示す互換性表があります。

KMP プロジェクトはサポート対象外のため、このスキルを使用しないでください。

手順

AGP がすでに 9 以上の場合は、次の手順を実行してください。

手順 1：依存関係を更新する

プロジェクトで KSP（com.google.devtools.ksp）を使用している場合は、バージョンが 2.3.6 以上であることを確認してください。

プロジェクトで Hilt を使用している場合は、バージョンが 2.59.2 以上であることを確認してください。

手順 2：組み込み Kotlin に移行する

詳しくはガイドを参照してください。

手順 3：新しい AGP DSL に移行する

詳しくはガイドを参照してください。

古いコードを AGP 9 と新しい DSL に対応したコードに移行する例については、gradle-recipesも参照してください。

手順 4：kapt から KSP または legacy-kapt に移行する

プロジェクトで KSP（com.google.devtools.ksp）または kapt（org.jetbrains.kotlin.kapt）を使用している場合は、詳細な移行手順についてKSP、kapt、legacy-kaptを参照してください。

手順 5：BuildConfig

Android モジュールにカスタム BuildConfig フィールドが含まれている場合は、詳しくはBuildConfigを参照してください。

手順 6：gradle.properties を更新する

移行後、gradle.properties を確認してください。次のフラグを削除します。

  1. android.builtInKotlin
  2. android.newDsl
  3. android.uniquePackageNames
  4. android.enableAppCompileTimeRClass

さらに、作成した一時ファイルをすべて削除してください。

ガイドライン

  • Python スクリプトを作成または実行しないでください。
  • 外部依存関係を調査する際は、最後の手段としてのみ Gradle の依存関係キャッシュを検索してください。
  • android.disallowKotlinSourceSets=false を gradle.properties に追加しないでください。
  • 変更を検証する際に、clean タスクを実行しないでください。時間の無駄です。

検証

移行後、次の項目を確認してください。

  1. Gradle IDE の同期が成功する。
  2. ./gradlew help が成功する。
  3. ./gradlew build --dry-run が成功する。

トラブルシューティング

Paparazzi v2.0.0-alpha04 以前のバージョンには、AGP 9 との互換性に関する問題があります。詳細はreferences/paparazzi-gradle-9.mdを参照してください。

コメント

Markdown 対応