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 ファイルで名前空間を設定する必要があります。 記述する必要があります。namespace DSL プロパティは AGP 7.3 以降で使用できます。詳細については、名前空間を設定するをご覧ください。

名前空間 DSL に移行する場合は、次の点に注意してください。

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

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

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

AGP 8.0 以降、これらのフラグのデフォルト値は ビルドのパフォーマンスを向上させることができます。これらの変更の一部をサポートするようにコードを調整する際にサポートが必要な場合は、AGP Upgrade Assistant（[Tools] > [AGP Upgrade Assistant]）を使用してください。Upgrade Assistant のガイドでは、 新しい動作に合わせてコードを更新するか、またはフラグを設定して 変更することもできます。

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

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

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

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

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

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

ビルド スクリプトに Gradle の Kotlin DSL を使用する場合は、 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"
  }
}

デフォルトのプロファイルをオーバーライドするには、 android.experimental.settings.executionProfile プロパティ gradle.properties ファイル:

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 ユーザーはプロジェクトの設定を変更する必要がありません。

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

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

修正された問題

Android Gradle プラグイン 8.0.0

Android Gradle プラグイン 8.0.1

Android Gradle プラグイン 8.0.2