Android Gradle プラグイン 8.1.0（2023 年 7 月）

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

互換性

Kotlin DSL がビルド構成のデフォルト

新しいプロジェクトでは、ビルド構成にデフォルトで Kotlin DSL（build.gradle.kts）が使用されるようになりました。これにより、構文のハイライト表示、コード補完、宣言へのナビゲーションなど、Groovy DSL（build.gradle）よりも優れた編集エクスペリエンスが実現します。AGP 8.1 と Kotlin DSL を使用してビルド構成を行う場合は、最適なエクスペリエンスを実現するために Gradle 8.1 を使用する必要があります。詳細については、Kotlin DSL 移行ガイドをご覧ください。

アプリ別の言語の自動サポート

Android Studio Giraffe Canary 7 および AGP 8.1.0-alpha07 以降では、アプリで自動的にアプリ別の言語設定をサポートするよう設定できます。Android Gradle プラグインは、プロジェクト リソースに基づいて LocaleConfig ファイルを生成し、そのファイルへの参照を最終マニフェスト ファイルに追加します。そのため、手動で行う必要はありません。AGP は、アプリ モジュールの res フォルダ内のリソースと、ライブラリ モジュールの依存関係を使用して、LocaleConfig ファイルに含めるロケールを決定します。

自動のアプリ別の言語機能は、Android 13（API レベル 33）以降を実行するアプリをサポートしています。この機能を使用するには、compileSdkVersion を 33 以上に設定する必要があります。以前のバージョンの Android のアプリ別の言語設定を設定するには、API とアプリ内言語選択ツールを使用する必要があります。

アプリ別の言語の自動サポートを有効にするには、デフォルトの言語 / 地域を指定します。

1. アプリ モジュールの res フォルダに、resources.properties という名前の新しいファイルを作成します。

2. resources.properties ファイルで、unqualifiedResLocale ラベルを使用してデフォルトのロケールを設定します。ロケール名を形成するには、言語コードをスクリプトや地域コード（省略可）と組み合わせ、それぞれをダッシュで区切ります。

   • 言語: 2 文字または 3 文字の ISO 639-1 コードを使用します。
   • スクリプト（省略可）: ISO 15924 コードを使用します。
   • 地域（省略可）: 2 文字の ISO 3166-1-alpha-2 コードまたは 3 桁の UN_M.49 コードを使用します。

   たとえば、デフォルトのロケールがアメリカ英語である場合は次のとおりです。

       unqualifiedResLocale=en-US
       

AGP は、このデフォルトのロケールと、res フォルダの values-* ディレクトリを使用して指定した代替ロケールを、自動生成された LocaleConfig ファイルに追加します。

アプリ別の言語の自動サポートはデフォルトでオフになっています。この機能を有効にするには、モジュール レベルの build.gradle.kts ファイル（Groovy を使用している場合は build.gradle ファイル）の androidResources {} ブロックで generateLocaleConfig 設定を使用します。

android {
  androidResources {
    generateLocaleConfig = true
  }
}

android {
  androidResources {
    generateLocaleConfig true
  }
}

Android Lint に JVM 17 をターゲットとするバイトコードが含まれている

AGP 8.1.0-alpha04 以降、Android Lint には JVM 17 をターゲットとするバイトコードが含まれています。カスタム lint チェックを記述する場合は、JDK 17 以降でコンパイルし、Kotlin コンパイラ オプションで jvmTarget = '17' を指定する必要があります。

lint ツールの詳細については、lint チェックでコードを改善するをご覧ください。

ネイティブ ライブラリの圧縮設定を DSL に移動

AGP 8.1.0-alpha10 以降では、マニフェストではなく DSL を使用してネイティブ ライブラリの圧縮を構成しないと、警告が表示されます。次のガイダンスでは、DSL を使用するように構成を更新する方法について説明します。これらの更新を行う際にサポートが必要な場合は、AGP Upgrade Assistant（[Tools] > [AGP Upgrade Assistant]）を使用してください。

圧縮されていないネイティブ ライブラリを使用するには、マニフェストから android::extractNativeLibs 属性を削除し、モジュール レベルの build.gradle.kts ファイル（Groovy を使用している場合は build.gradle ファイル）に次のコードを追加します。

android {
  packagingOptions {
    jniLibs {
      useLegacyPackaging = false
    }
  }
}

android {
  packagingOptions {
    jniLibs {
      useLegacyPackaging false
    }
  }
}

試験運用版のビルドフラグ

これらは、AGP 8.1 で利用可能なビルドを構成するための試験運用版フラグです。

修正された問題

Android Gradle プラグイン 8.1.0

Android Gradle プラグイン 8.1.1

Android Gradle プラグイン 8.1.2

Android Gradle プラグイン 8.1.3

Android Gradle プラグイン 8.1.4