Android Gradle プラグイン 8.0.0（2023 年 4 月）

Android Gradle プラグイン 8.0.0 はメジャー リリースで、さまざまな新機能や改善が組み込まれています。

互換性

パッチリリース

Android Gradle プラグイン 8.0 のパッチリリースを以下に示します。

Android Gradle プラグイン 8.0.2（2023 年 5 月）

AGP 8.0.2 で修正されたバグの一覧については、Android Studio 2022.2.1 のクローズされた問題をご覧ください。

Android Gradle プラグイン 8.0.1（2023 年 5 月）

このマイナー アップデートには、次のバグの修正が含まれています。

互換性を破る変更: モジュール レベルのビルド スクリプトで名前空間が必須に

名前空間は、マニフェスト ファイルではなく、モジュール レベルの build.gradle.kts ファイルで設定する必要があります。AGP 7.3 以降では、namespace DSL プロパティを使用できます。詳しくは、名前空間を設定するをご覧ください。

名前空間 DSL に移行する際は、次の問題に注意してください。

• 以前のバージョンの AGP では、メインの名前空間またはアプリケーション ID からテストの名前空間が推測されることがあり、場合によっては誤って推測されることがありました。AGP アップグレード アシスタントは、プロジェクトのメインの名前空間とテストの名前空間が同じであることを検出すると、アップグレードをブロックします。アップグレードがブロックされている場合は、testNamespace を手動で変更し、それに応じてソースコードを変更する必要があります。
• テストの名前空間を変更すると、コードはコンパイルされるものの、インストルメンテーション テストが実行時に失敗する可能性があります。これは、インストルメンテーション テストのソースコードが、androidTest とアプリのソースの両方で定義されているリソースを参照している場合に発生することがあります。

詳しくは、問題 #191813691 のコメント #19 をご覧ください。

互換性を破る変更: ビルド オプションのデフォルト値

AGP 8.0 以降、ビルド パフォーマンスを向上させるために、これらのフラグのデフォルト値が変更されました。これらの変更の一部をサポートするようにコードを調整する際にヘルプが必要な場合は、AGP Upgrade Assistant（[Tools] > [AGP Upgrade Assistant]）を使用してください。アップグレード アシスタントは、新しい動作に対応するようにコードを更新するか、以前の動作を維持するようにフラグを設定する手順を案内します。

互換性を破る変更: ビルド オプション値の適用

AGP 8.0 以降、これらのフラグの値は変更できなくなりました。gradle.properties ファイルで指定すると、値は無視され、AGP が警告を出力します。

実行プロファイルの新しい安定版フラグ

AGP に新しいフラグ android.settings.executionProfile が追加されました。このフラグを使用すると、SettingsExtension のデフォルトの実行プロファイルをオーバーライドできます。詳細については、設定プラグインのドキュメントをご覧ください。

試験運用版フラグをプレビューするには、プレビュー リリースノートをご覧ください。

Kotlin の遅延プロパティ割り当てはサポートされていません

ビルド スクリプトに Gradle の Kotlin DSL を使用している場合、Android Studio と AGP 8.0 は = 演算子を使用した試験運用版のプロパティ割り当てをサポートしていません。この機能の詳細については、リリースノートとドキュメントをご覧ください。

Build Analyzer のタスクカテゴリ

Android Studio Flamingo 以降、Build Analyzer には、ビルド時間に影響するタスクの新しいデフォルト ビューが用意されています。プロジェクトで AGP 8.0 以降を使用している場合、Build Analyzer はタスクを個別に表示するのではなく、カテゴリ別にグループ化します。たとえば、Android リソース、Kotlin、Dexing に固有のタスクがグループ化され、ビルド時間で並べ替えられます。これにより、ビルド時間に最も影響を与えるカテゴリを特定できます。各カテゴリを開くと、対応するタスクのリストが表示されます。タスクをグループ化せずに個別に表示するには、[グループ条件] プルダウンを使用します。

新しい設定プラグイン

AGP 8.0.0-alpha09 で、新しい設定プラグインが導入されました。設定プラグインを使用すると、すべてのモジュールに適用されるグローバル構成を 1 か所に集中管理できるため、複数のモジュールに構成をコピーして貼り付ける必要がなくなります。さらに、設定プラグインを使用して、ツールの実行プロファイル（ツールの実行方法に関するさまざまな指示）を作成し、それらを切り替えることができます。

設定プラグインを使用するには、settings.gradle ファイルでプラグインを適用します。

apply plugin 'com.android.settings'

グローバル構成を一元化する

グローバル構成を構成するには、settings.gradle ファイルの新しい android ブロックを使用します。次の例をご覧ください。

android {
  compileSdk 31
  minSdk 28
  ...
}

ツール実行プロファイル

設定プラグインを使用すると、一部のツールの実行プロファイルを作成することもできます。実行プロファイルは、ツールの実行方法を決定します。環境に応じて異なる実行プロファイルを選択できます。実行プロファイルでは、ツールの JVM 引数を設定し、別のプロセスで実行するように構成できます。R8 ツールのみがサポートされています。

次の例に示すように、実行プロファイルを作成し、settings.gradle ファイルにデフォルトの実行プロファイルを設定します。

android {
  execution {
    profiles {
      high {
        r8 {
          jvmOptions += ["-Xms2048m", "-Xmx8192m", "-XX:+HeapDumpOnOutOfMemoryError"]
          runInSeparateProcess true
        }
      }
      low {
        r8 {
          jvmOptions += ["-Xms256m", "-Xmx2048m", "-XX:+HeapDumpOnOutOfMemoryError"]
          runInSeparateProcess true
        }
      }
      ci {
        r8.runInSeparateProcess false
      }
    }
    defaultProfile "low"
  }
}

デフォルトのプロファイルをオーバーライドするには、gradle.properties ファイルの android.experimental.settings.executionProfile プロパティを使用して別のプロファイルを選択します。

android.experimental.settings.executionProfile=high

このプロパティはコマンドラインを使用して設定することもできます。これにより、さまざまなワークフローを設定できます。たとえば、継続的インテグレーション ワークフローがある場合は、settings.gradle ファイルを変更せずに、コマンドラインを使用して実行プロファイルを変更できます。

./gradlew assembleRelease \
-Pandroid.experimental.settings.executionProfile=ci

AGP 8.0 の実行に JDK 17 が必要

Android Gradle プラグイン 8.0 を使用してアプリをビルドする場合、Gradle を実行するために JDK 17 が必要になりました。Android Studio Flamingo には JDK 17 がバンドルされており、Gradle がデフォルトでこれを使用するように設定されています。そのため、ほとんどの Android Studio ユーザーはプロジェクトの設定を変更する必要がありません。

Android Studio 内で AGP が使用する JDK バージョンの設定を手動で行う必要がある場合は、JDK 17 以降を使用する必要があります。

Android Studio とは別に AGP を使用する場合は、JAVA_HOME 環境変数または -Dorg.gradle.java.home コマンドライン オプションを JDK 17 のインストール ディレクトリに設定することにより、JDK バージョンをアップグレードしてください。

解決済みの問題

Android Gradle プラグイン 8.0.2

Android Gradle プラグイン 8.0.1

Android Gradle プラグイン 8.0.0