Android Gradle プラグイン 9.0.0（2026 年 1 月）

Android Gradle プラグイン 9.0 は、API と動作の変更をもたらすメジャー リリースです。

Android Gradle プラグイン 9.0.0 に更新するには、Android Gradle プラグイン Upgrade Assistant を使用します。

AGP Upgrade Assistant は、プロジェクトをアップグレードする際に、必要に応じて既存の動作を保持します。これにより、AGP 9.0 の新しいデフォルトをすべて採用する準備ができていない場合でも、プロジェクトをアップグレードして AGP 9.0 を使用できます。

互換性

Android Gradle プラグイン 9.0 でサポートされる最大 API レベルは 36 です。その他の互換性情報は以下のとおりです。

android DSL クラスは、新しい公開インターフェースのみを実装するようになりました

過去数年間、Google は DSL と API の新しいインターフェースを導入し、公開する API をより適切に制御できるようにしてきました。AGP バージョン 7.x と 8.x では、インターフェースの作業の進行に合わせて互換性を維持するため、新しい公開インターフェースも実装した古い DSL タイプ（BaseExtension など）が引き続き使用されていました。

AGP 9.0 では、新しい DSL インターフェースのみが使用され、実装は完全に隠蔽された新しい型に変更されました。これにより、非推奨の古いバリアント API へのアクセスも削除されます。

AGP 9.0 に更新するには、次の操作が必要になる場合があります。

• プロジェクトが組み込みの Kotlin と互換性があることを確認する: org.jetbrains.kotlin.android プラグインは新しい DSL と互換性がありません。

• KMP プロジェクトを Android Gradle Library Plugin for KMP に切り替える: com.android.library プラグインと com.android.application プラグインと同じ Gradle サブプロジェクトで org.jetbrains.kotlin.multiplatform プラグインを使用することは、新しい DSL と互換性がありません。

• ビルドファイルを更新する: インターフェースの変更は、DSL をできるだけ類似した状態に保つことを目的としていますが、小さな変更が生じる可能性があります。

• 新しい DSL と API を参照するようにカスタムビルド ロジックを更新します。 内部 DSL への参照をすべて公開 DSL インターフェースに置き換えます。ほとんどの場合、これは 1 対 1 の置き換えになります。applicationVariants などの API の使用箇所を、新しい androidComponents API に置き換えます。androidComponents API はプラグインの互換性を長く維持するために安定性を高めるように設計されているため、この方法はより複雑になる可能性があります。例については、Gradle のレシピをご覧ください。

• サードパーティ製プラグインを更新する: サードパーティ製プラグインの中には、公開されなくなったインターフェースや API に依存しているものがあります。AGP 9.0 と互換性のあるプラグインのバージョンに移行します。

新しい DSL インターフェースに切り替えることで、次のようなさまざまな非推奨 API を使用するプラグインや Gradle ビルドスクリプトが防止されます。

androidComponents {
    onVariants() { variant ->
        variant.signingConfig
            .enableV1Signing.set(false)
    }
}

androidComponents {
    beforeVariants(
        selector()
            .withBuildType("debug")
            .withFlavor("color", "blue")
    ) { variantBuilder ->
        variantBuilder.enable = false
    }
  }

AGP 9.0 に更新したときに次のエラー メッセージが表示された場合は、プロジェクトが古い型の一部を参照していることを意味します。

java.lang.ClassCastException: class com.android.build.gradle.internal.dsl.ApplicationExtensionImpl$AgpDecorated_Decorated
cannot be cast to class com.android.build.gradle.BaseExtension

互換性のないサードパーティ製プラグインによってブロックされている場合は、オプトアウトして、DSL の古い実装と古いバリアント API を取得できます。この間も新しいインターフェースは利用可能で、独自のビルド ロジックを新しい API に更新することもできます。オプトアウトするには、gradle.properties ファイルに次の行を含めます。

android.newDsl=false

AGP 9.0 にアップグレードする前に、新しい API へのアップグレードを開始することもできます。新しいインターフェースは多くの AGP バージョンに存在するため、新旧のインターフェースを混在させることができます。AGP API リファレンス ドキュメントには、各 AGP バージョンの API サーフェスと、各クラス、メソッド、フィールドが追加された時期が記載されています。

9.0 のアルファ版の段階で、プラグインの作成者に連絡を取り、新しいモードに完全に対応したプラグインを適応させてリリースできるようサポートします。また、Android Studio の AGP Upgrade Assistant を強化して、移行をガイドします。

新しい DSL または Variant API に機能が不足していることが判明した場合は、できるだけ早く問題を報告してください。

Kotlin が組み込まれている

Android Gradle プラグイン 9.0 では、Kotlin の組み込みサポートが導入され、デフォルトで有効になります。つまり、Kotlin ソースファイルをコンパイルするために、ビルドファイルで org.jetbrains.kotlin.android（または kotlin-android）プラグインを適用する必要がなくなります。これにより、AGP との Kotlin 統合が簡素化され、非推奨の API の使用が回避され、場合によってはパフォーマンスが向上します。

そのため、プロジェクトを AGP 9.0 にアップグレードする際は、組み込みの Kotlin に移行するか、オプトアウトする必要があります。

Kotlin ソースがない Gradle サブプロジェクトに対して、Kotlin の組み込みサポートを選択的に無効にすることもできます。

Kotlin Gradle プラグインの実行時の依存関係

Kotlin の組み込みサポートを提供するため、Android Gradle プラグイン 9.0 には Kotlin Gradle プラグイン（KGP）2.2.10 に対するランタイム依存関係が追加されました。つまり、KGP バージョンを宣言する必要がなくなり、2.2.10 より前の KGP バージョンを使用している場合は、Gradle が KGP バージョンを 2.2.10 に自動的にアップグレードします。同様に、2.2.10-2.0.2 より前の KSP バージョンを使用している場合、AGP は KGP バージョンに合わせて 2.2.10-2.0.2 にアップグレードします。

上位の KGP バージョンにアップグレードする

より新しいバージョンの KGP または KSP を使用するには、最上位のビルドファイルに以下を追加します。

buildscript {
    dependencies {
        // For KGP
        classpath("org.jetbrains.kotlin:kotlin-gradle-plugin:KGP_VERSION")

        // For KSP
        classpath("com.google.devtoolsksp:symbol-processing-gradle-plugin:KSP_VERSION")
    }
}

下位の KGP バージョンにダウングレードする

KGP のバージョンをダウングレードできるのは、組み込みの Kotlin をオプトアウトした場合のみです。これは、AGP 9.0 で組み込み Kotlin がデフォルトで有効になり、組み込み Kotlin には KGP 2.2.10 以降が必要になるためです。

以前のバージョンの KGP または KSP を使用するには、厳密なバージョン宣言を使用して、最上位のビルドファイルでそのバージョンを宣言します。

buildscript {
    dependencies {
        // For KGP
        classpath("org.jetbrains.kotlin:kotlin-gradle-plugin") {
            version { strictly("KGP_VERSION") }
        }

        // For KSP
        classpath("com.google.devtoolsksp:symbol-processing-gradle-plugin") {
            version { strictly("KSP_VERSION") }
        }
    }
}

ダウングレードできる KGP の最小バージョンは 2.0.0 です。

テスト フィクスチャの IDE サポート

AGP 9.0 では、テスト フィクスチャの Android Studio IDE の完全なサポートが導入されています。

Fused ライブラリ プラグイン

Fused Library プラグイン（プレビュー）を使用すると、複数のライブラリを 1 つの Android ライブラリ AAR として公開できます。これにより、ユーザーが公開されたアーティファクトに依存しやすくなります。

スタートガイドについては、Fused Library を使用して複数の Android ライブラリを 1 つとして公開するをご覧ください。

動作の変更

Android Gradle プラグイン 9.0 には、次の新しい動作があります。

AGP 9.0 には、次の Gradle プロパティのデフォルトの更新が含まれています。これにより、アップグレード時に AGP 8.13 の動作を維持するかどうかを選択できます。

android {
  defaultConfig {
    testInstrumentationRunner = "..."
  }
}

android {
  buildFeatures {
    resValues = true
  }
}

android {
  buildFeatures {
    shaders = true
  }
}

削除された機能

Android Gradle プラグイン 9.0 では、次の機能が削除されています。

• Wear OS アプリの埋め込みのサポート
  AGP 9.0 では、Wear OS アプリの埋め込みのサポートが削除されました。この機能は Google Play でサポートされなくなりました。これには、wearApp 構成と AndroidSourceSet.wearAppConfigurationName DSL の削除が含まれます。アプリを Wear OS に公開する方法については、Wear OS への配信をご覧ください。
• androidDependencies および sourceSets レポートタスク
• 密度の分割 APK のサポート
  AGP 9.0 では、画面密度に基づく分割 APK の作成のサポートが削除されました。この機能と関連する API が削除されました。AGP 9.0 以降を使用して画面密度に基づいて APK を分割するには、アプリバンドルを使用します。

変更された DSL

Android Gradle プラグイン 9.0 には、次の破壊的な DSL の変更が含まれています。

• CommonExtension のパラメータ化が削除されました。

  これ自体は、将来のソースレベルの破壊的変更を回避するためのソースレベルの破壊的変更にすぎませんが、ブロック メソッドを CommonExtension から ApplicationExtension、LibraryExtension、DynamicFeatureExtension、TestExtension に移動する必要があることも意味します。

  プロジェクトを AGP 9.0 にアップグレードする場合は、これらのパラメータまたはブロック メソッドを使用する Gradle プラグイン コードをリファクタリングします。たとえば、次のプラグインは、型パラメータを削除し、削除されたブロック メソッドに依存しないように更新されます。

  AGP 8.13

  val commonExtension: CommonExtension<*, *, *, *, *, *> =
          extensions.getByType(CommonExtension::class)
  commonExtension.apply {
      defaultConfig {
          minSdk {
              version = release(28)
          }
      }
  }
  

  AGP 9.0

  val commonExtension: CommonExtension =
          extensions.getByType(CommonExtension::class)
  commonExtension.apply {
      defaultConfig.apply {
          minSdk {
              version = release(28)
          }
      }
  }
  

  AGP のバージョン範囲を対象とするプラグインの場合、ゲッターを直接使用すると、9.0 より前の AGP バージョンとのバイナリ互換性が維持されます。

DSL を削除しました

Android Gradle プラグイン 9.0 では、次のものが削除されています。

• AndroidSourceSet.jni（機能していなかったため）。

• AndroidSourceSet.wearAppConfigurationName（削除された埋め込み Wear OS アプリのサポートに関連するもの）。

• BuildType.isRenderscriptDebuggable（機能していなかったため）。

• DependencyVariantSelection。DependencySelection に置き換えられ、kotlin.android.localDependencySelection として公開されます。

• Installation.installOptions(String)。Installation.installOptions の可変プロパティに置き換えられます。

• 試験運用中だが安定化されていない PostProcessing ブロック。

• ProductFlavor.setDimension（dimension プロパティに置き換えられました）

• LanguageSplitOptions は Google Play Instant でのみ使用されていましたが、非推奨になりました。

• DensitySplit。この機能はサポートされなくなったためです。代替手段は、App Bundle を使用することです。

削除された API

Android Gradle プラグイン 9.0 では、次のものが削除されています。

• AndroidComponentsExtension.finalizeDSl。finalizeDsl に置き換えられました。

• Component.transformClassesWith。Instrumentation.transformClassesWith に置き換えられました。

• Component.setAsmFramesComputationMode。Instrumentation.setAsmFramesComputationMode に置き換えられました。

• ComponentBuilder.enabled。ComponentBuilder.enable に置き換えられました。

• DependenciesInfoBuilder.includedInApk。これは includeInApk に置き換えられます。

• DependenciesInfoBuilder.includedInBundle。これは includeInBundle に置き換えられます。

• GeneratesApk.targetSdkVersion。targetSdk に置き換えられました。

• Variant.minSdkVersion。minSdk に置き換えられました。

• Variant.maxSdkVersion。maxSdk に置き換えられました。

• Variant.targetSdkVersion。targetSdk に置き換えられました。

• Variant.unitTest。com.android.test プラグインには適用されなかったためです。unitTest は、HasUnitTest を拡張する VariantBuilder サブタイプで使用できます。

• VariantBuilder.targetSdk と targetSdkPreview はライブラリでは意味がないため、削除されました。代わりに GeneratesApkBuilder.targetSdk または GeneratesApkBuilder.targetSdkPreview を使用してください。

• VariantBuilder.enableUnitTest。com.android.test プラグインには適用されなかったためです。enableUnitTest は、HasUnitTestBuilder を拡張する VariantBuilder サブタイプで使用できます。

• HasUnitTestBuilder を拡張する VariantBuilder サブタイプで、より一貫性のある名前の enableUnitTest を優先して VariantBuilder.unitTestEnabled が削除されました。

• VariantOutput.enable。enabled に置き換えられました。

• 非推奨で無効になっている FeaturePlugin と FeatureExtension。

• 非推奨となり無効化された BaseExtension.registerTransform API。これは、AGP 4.2 以前での実行をターゲットにしながら、最新の AGP バージョンに対するコンパイルを可能にするためだけに残されていました。

削除された Gradle プロパティ

次の Gradle プロパティは、デフォルトで有効になっている機能をグローバルに無効にする方法として最初に追加されました。

これらの機能は、AGP 8.0 以下ではデフォルトで無効になっています。これらの機能を使用するサブプロジェクトでのみ有効にすると、ビルドの効率が向上します。

android {
  buildFeatures {
    aidl = true
  }
}

android {
  buildFeatures {
    renderScript = true
  }
}

適用される Gradle プロパティ

次の Gradle プロパティを設定すると、AGP 9.0 はエラーをスローします。

これらのプロパティを使用するプロジェクトは、Android Gradle プラグイン Upgrade Assistant で AGP 9.0 にアップグレードされません。

R8 の変更

AGP 9.0.0 には次の R8 の変更が含まれています。

新しい構成オプション -processkotlinnullchecks

Kotlin の null チェックを処理するように R8 を構成するための新しい R8 オプション -processkotlinnullchecks を追加しました。このオプションは、keep、remove_message、remove のいずれかの値にする必要がある必須引数を取ります。このオプションは、Kotlin コンパイラによって追加された次の null チェックを処理します。

class kotlin.jvm.internal.Intrinsics {
  void checkNotNull(java.lang.Object);
  void checkNotNull(java.lang.Object, java.lang.String);
  void checkExpressionValueIsNotNull(
      java.lang.Object, java.lang.String);
  void checkNotNullExpressionValue(
      java.lang.Object, java.lang.String);
  void checkReturnedValueIsNotNull(
      java.lang.Object, java.lang.String);
  void checkReturnedValueIsNotNull(
      java.lang.Object, java.lang.String, java.lang.String);
  void checkFieldIsNotNull(java.lang.Object, java.lang.String);
  void checkFieldIsNotNull(
      java.lang.Object, java.lang.String, java.lang.String);
  void checkParameterIsNotNull(java.lang.Object, java.lang.String);
  void checkNotNullParameter(java.lang.Object, java.lang.String);
}

オプション値は、弱い順から強い順に並べられ、次の効果があります。

• keep はチェックを変更しません。
• remove_message は、各チェック メソッド呼び出しを、呼び出しの最初の引数に対する getClass() の呼び出しに書き換えます（null チェックは実質的に維持されますが、メッセージはなくなります）。
• remove はチェックを完全に削除します。

デフォルトでは、R8 は remove_message を使用します。-processkotlinnullchecks の指定は、この設定をオーバーライドします。複数回指定された場合は、最も強い値が使用されます。

Keep 情報をコンパニオン メソッドに伝播しないようにする

以前は、keep ルールが desugaring の対象となるインターフェース メソッドと一致した場合、R8 は内部で 最適化の禁止ビットと縮小の禁止ビットを合成されたコンパニオン メソッドに転送していました。

AGP 9.0 以降では、保持ルールはコンパニオン メソッドに適用されなくなりました。これは、保持ルールがコンパイラによって合成された他のフィールド、メソッド、クラスに適用されないことと一致しています。

最適化の禁止ビットと縮小の禁止ビットをコンパニオン メソッドに転送することで、以前は次のユースケースがサポートされていました。

1. default/static/private インターフェース メソッドを含むライブラリを、minSdk < 24 とインターフェース メソッドを保持するルールを使用して DEX にコンパイルします。
2. クラスパスと -applymapping にライブラリを指定してアプリをコンパイルします。
3. アプリとライブラリを統合します。

これは -applymapping でのみ機能します。disallow obfuscation ビットはコンパニオン メソッドに転送されないため、ステップ 1 で生成されたコンパニオン クラスには難読化されたメソッド名が含まれます。

今後、このユースケースは minSdk < 24 ではサポートされなくなります。この問題を回避するには、次の操作を行います。

1. default/static/private インターフェース メソッドを含むライブラリを、minSdk < 24 のクラスファイルに脱糖します。
2. R8 と、コンパニオン クラスのインターフェース メソッドを保持するルールを使用して、脱糖されたアーティファクトをコンパイルします。
3. クラスパス上のライブラリを使用してアプリをコンパイルします。
4. アプリと脱糖されたアーティファクトをマージします。

この副作用として、匿名クラスとローカルクラスの内部クラスと外側のメソッド属性をインターフェース コンパニオン メソッド内に保持できなくなりました。

デフォルトの出力ソースファイルを r8-map-id-<MAP_ID> に変更

この変更は AGP 8.12.0 以降に適用されます。

クラスのデフォルトの出力ソースファイル属性は、リトレースが必要な場合（つまり、難読化または最適化のいずれかが有効になっている場合）、SourceFile から r8-map-id-<MAP_ID> に変更されます。

難読化されたスタック トレースが与えられた場合、新しいソースファイル属性により、再トレースに必要なマッピング ファイルの ID を抽出できるようになります。この ID は、Logcat でのスタック トレースの自動再トレースをサポートするために使用できます。

カスタム ソースファイル属性（-renamesourcefileattribute）が使用されている場合は、このカスタム ソースファイル属性が引き続き優先されます。

ProGuard 互換モード（gradle.properties に android.enableR8.fullMode=false が含まれている場合）では、r8-map-id-<MAP_ID> のソースファイル属性の出力は、SourceFile 属性が保持されていない場合にのみ有効になります。ProGuard 互換モードを使用し、マッピング ファイル ID をスタック トレースに含めたいアプリは、-keepattributes SourceFile を削除する必要があります（または R8 フルモードに移行する必要があります）。

r8-map-id-<MAP_ID> で使用されるマップ ID は、以前使用されていたマップハッシュの 7 文字の接頭辞ではなく、マップハッシュ全体です。

L8 の脱糖で最小化された合成名の使用を有効にする

D8 によって生成された合成クラスの名前には通常、D8 によって生成された合成クラスであることを示す $$ExternalSynthetic というサブ文字列が含まれています。また、合成の名前には合成の種類（Backport、Lambda など）もエンコードされます。クラス名が文字列プールでより多くのスペースを占有するため、結果として得られる DEX のサイズに悪影響を及ぼします。

AGP 9.0 は、すべての j$ クラスを含む DEX ファイルが合成クラスに新しい短縮クラス名形式を使用するように L8（コア ライブラリの脱糖）を構成します。新しいクラス名では数値 ID が使用されます（例: $1）。

-addconfigurationdebugging のサポートを削除

AGP 9.0 では -addconfigurationdebugging のサポートが削除されます。このフラグが使用されると、コンパイラが警告を報告するようになりました。

D8/R8 から L8 ルールを生成するサポートを削除

この変更は、D8/R8 コマンドラインまたは API を直接使用するデベロッパーにのみ関連します。

R8 9.0 では、D8 および R8 から L8 のキープルールを生成するサポートが削除されました。代わりに、この目的には TraceReferences を使用する必要があります。

具体的には、D8Command.builder.setDesugaredLibraryKeepRuleConsumer メソッドと R8Command.Builder.setDesugaredLibraryKeepRuleConsumer メソッドが削除され、D8 と R8 のコマンドライン オプションから --desugared-lib-pg-conf-output のサポートが削除されます。

修正された問題

Android Gradle プラグイン 9.0.0-rc03

Android Gradle プラグイン 9.0.0-rc02

Android Gradle プラグイン 9.0.0-rc01

Android Gradle プラグイン 9.0.0-beta05

Android Gradle プラグイン 9.0.0-beta04

Android Gradle プラグイン 9.0.0-beta03

Android Gradle プラグイン 9.0.0-beta02

Android Gradle プラグイン 9.0.0-beta01

Android Gradle プラグイン 9.0.0-alpha14

Android Gradle プラグイン 9.0.0-alpha13

Android Gradle プラグイン 9.0.0-alpha12

Android Gradle プラグイン 9.0.0-alpha11

Android Gradle プラグイン 9.0.0-alpha10

Android Gradle プラグイン 9.0.0-alpha09

Android Gradle プラグイン 9.0.0-alpha08

Android Gradle プラグイン 9.0.0-alpha07

Android Gradle プラグイン 9.0.0-alpha06

Android Gradle プラグイン 9.0.0-alpha05

Android Gradle プラグイン 9.0.0-alpha04

Android Gradle プラグイン 9.0.0-alpha03

Android Gradle プラグイン 9.0.0-alpha02

Android Gradle プラグイン 9.0.0-alpha01

Android Gradle プラグイン 9.0.0