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++ コンパイラ出力のみを表示します。以前は、ビルドされたファイルごとに出力行が生成されるため、大量の情報メッセージが生成されていました。

ネイティブ出力全体を表示したい場合は、新しい 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 に代わるものです。詳しい背景情報については、リリースノートの非圧縮ネイティブ ライブラリパッケージ化（デフォルト）をご覧ください。