Android Gradle プラグイン 4.2.0（2021 年 3 月）

互換性

新しい機能と特長

このバージョンの Android Gradle プラグインには、次の新機能が含まれています。

Java 言語バージョン 8（デフォルト）

バージョン 4.2 以降、AGP はデフォルトで Java 8 言語レベルを使用します。Java 8 では、ラムダ式、メソッド参照、静的インターフェース メソッドなど、多くの新しい言語機能にアクセスできます。サポートされている機能の一覧については、Java 8 のドキュメントをご覧ください。

以前の動作を維持するには、モジュール レベルの build.gradle.kts または build.gradle ファイルで Java 7 を明示的に指定します。

// build.gradle
android {
  ...
  compileOptions {
    sourceCompatibility JavaVersion.VERSION_1_7
    targetCompatibility JavaVersion.VERSION_1_7
  }
  // For Kotlin projects, compile to Java 6 instead of 7
  kotlinOptions {
    jvmTarget = "1.6"
  }
}

// build.gradle.kts
android {
  ...
  compileOptions {
    sourceCompatibility = JavaVersion.VERSION_1_7
    targetCompatibility = JavaVersion.VERSION_1_7
  }
  // For Kotlin projects, compile to Java 6 instead of 7
  kotlinOptions {
    jvmTarget = "1.6"
  }
}

新しい JVM リソース コンパイラ

Android Gradle プラグイン 4.2 ツールの新しい JVM リソース コンパイラにより、AAPT2 リソース コンパイラの一部が置き換えられるため、特に Windows マシンでビルドのパフォーマンスが向上する可能性があります。新しい JVM リソース コンパイラはデフォルトで有効になっています。

v3 と v4 の署名のサポート

Android Gradle プラグイン 4.2 が APK v3 と APK v4 の署名形式をサポートするようになりました。 これらの形式のいずれかまたは両方をビルドで有効にするには、次のプロパティをモジュール レベルの build.gradle ファイルまたは build.gradle.kts ファイルに追加します。

// build.gradle
android {
  ...
  signingConfigs {
    config {
        ...
        enableV3Signing true
        enableV4Signing true
    }
  }
}

// build.gradle.kts
android {
  ...
  signingConfigs {
      config {
          ...
          enableV3Signing = true
          enableV4Signing = true
      }
  }
}

APK v4 署名を使用すると、Android 11 の ADB の増分 APK インストールを使用して、サイズの大きい APK をすばやくデプロイできます。この新しいフラグにより、デプロイ プロセスの APK 署名手順が処理されます。

バリアントごとにアプリ署名を設定する

Android Gradle プラグインのバリアントごとにアプリ署名を有効または無効にすることができるようになりました。

この例では、Kotlin または Groovy で onVariants() メソッドを使用して、バリアントごとにアプリ署名を設定する方法を示します。

androidComponents {
    onVariants(selector().withName("fooDebug"), {
        signingConfig.enableV1Signing.set(false)
        signingConfig.enableV2Signing.set(true)
    })

新しい Gradle プロパティ: android.native.buildOutput

ビルド出力を見やすくするために、AGP 4.2 では、CMake と ndk-build を使用するネイティブ ビルドからのメッセージがフィルタされ、デフォルトでは C/C++ コンパイラ出力のみが表示されます。以前は、ビルドされたファイルごとに 1 行の出力が生成されるため、大量の情報メッセージが出力されていました。

ネイティブ出力全体を表示する場合は、新しい Gradle プロパティ android.native.buildOutput を verbose に設定します。

このプロパティは、gradle.properties ファイルまたはコマンドラインで設定できます。

gradle.properties
android.native.buildOutput=verbose

コマンドライン
-Pandroid.native.buildOutput=verbose

このプロパティのデフォルト値は quiet です。

gradle.properties ファイルでの動作の変更

AGP 4.2 以降では、サブプロジェクトの Gradle プロパティをオーバーライドできなくなりました。つまり、ルート プロジェクトではなくサブプロジェクトの gradle.properties ファイルでプロパティを宣言した場合、そのプロパティは無視されます。

たとえば、以前のリリースでは、AGP は <var>projectDir</var>/gradle.properties、<var>projectDir</var>/app/gradle.properties、<var>projectDir</var>/library/gradle.properties などから値を読み取りていました。アプリ モジュールの場合、同じ Gradle プロパティが <var>projectDir</var>/gradle.properties と <var>projectDir</var>/app/gradle.properties の両方に存在する場合、<var>projectDir</var>/app/gradle.properties の値が優先されます。

AGP 4.2 ではこの動作が変更され、AGP はサブプロジェクトの gradle.properties から値を読み込まず、<var>projectDir</var>/app/gradle.properties）。この変更は、新しい Gradle の動作を反映しており、構成のキャッシュをサポートしています。

gradle.properties ファイルで値を設定する方法について詳しくは、Gradle のドキュメントをご覧ください。

Gradle の互換性と構成の変更

Android Studio で実行する場合、Gradle ビルドツールは Studio のバンドルされた JDK を使用します。以前のリリースでは、JDK 8 が Studio にバンドルされていました。しかし、4.2 では JDK 11 がバンドルされるようになりました。新しくバンドルされた JDK を使用して Gradle を実行すると、ガベージ コレクタに加えられた変更により、一部で非互換性が生じる場合や JVM のパフォーマンスが影響を受ける場合があります。以下では、これらの問題について説明します。

Studio と Android Gradle プラグイン（AGP）との互換性

Android Studio 4.2 では、AGP が Gradle 4.8.1 以降を実行している場合、AGP 3.1 以降を使用するプロジェクトを開くことができます。Gradle の互換性について詳しくは、Gradle をアップデートするをご覧ください。

Gradle ビルドを JDK 11 用に最適化する

JDK 11 へのこのアップデートは、JVM ガベージ コレクタのデフォルト構成に影響します。これは、JDK 8 では並列ガベージ コレクタを使用し、JDK 11 では G1 ガベージ コレクタを使用するためです。

ビルドのパフォーマンスを向上させるには、並列ガベージ コレクタを使用して Gradle ビルドをテストすることをおすすめします。gradle.properties で次のように設定します。

org.gradle.jvmargs=-XX:+UseParallelGC

このフィールドにすでに他のオプションが設定されている場合は、新しいオプションを追加します。

org.gradle.jvmargs=-Xmx1536m -XX:+UseParallelGC

さまざまな構成でビルド速度を測定するには、ビルドのプロファイリングを行うをご覧ください。

minSdk = 28 以上の場合に APK で非圧縮の DEX ファイルを使用する

minSdk = 28 以上の場合、AGP はデフォルトで非圧縮 DEX ファイルを APK でパッケージ化するようになりました。これにより、APK サイズが増加しますが、デバイス上のインストール サイズは小さくなり、ダウンロード サイズはほぼ同じです。

代わりに AGP で圧縮された DEX ファイルをパッケージ化するには、build.gradle ファイルに次の行を追加します。

android {
    packagingOptions {
        dex {
            useLegacyPackaging true
        }
    }
}

DSL を使用して圧縮ネイティブ ライブラリをパッケージ化する

ネイティブ ライブラリは非圧縮形式でパッケージ化することをおすすめします。アプリのインストール サイズ、ダウンロード サイズ、ユーザーの読み込み時間が短くなるためです。ただし、アプリのビルド時に Android Gradle プラグインで圧縮ネイティブ ライブラリをパッケージ化する場合は、アプリの build.gradle ファイルで useLegacyPackaging を true に設定します。

android {
    packagingOptions {
        jniLibs {
            useLegacyPackaging true
        }
    }
}

フラグ useLegacyPackaging はマニフェスト属性 extractNativeLibs に代わるものです。詳しい背景情報については、リリースノートの非圧縮ネイティブ ライブラリがデフォルトでパッケージ化されるをご覧ください。