Android Gradle プラグイン プレビューのリリースノート

このページには、Android Gradle プラグイン（AGP）のプレビュー リリースのリリースノートが記載されています。

Android Gradle プラグイン 9.0

Android Gradle プラグイン 9.0 は AGP の新しいメジャー リリースで、API と動作の変更が導入されています。

Android Gradle プラグイン 9.0.0-alpha10 にアップデートするには、Android Studio Otter | 2025.2.1 の Android Gradle プラグイン Upgrade Assistant を使用します。

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

互換性

Android Gradle プラグイン 9.0.0-alpha10 がサポートする最大 Android API レベルは API レベル 36 です。

Android Gradle プラグイン 9.0.0-alpha10 には Gradle 9.0.0 が必要です。

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

過去数年間、公開する API をより適切に制御するために、DSL と 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 のアルファ版の期間中、Google はプラグインの作成者に連絡を取り、新しいモードに完全に対応したプラグインを適応させてリリースできるようサポートします。また、Android Studio の AGP Upgrade Assistant を強化して、移行をガイドします。

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

Kotlin が組み込まれている

Android Gradle プラグイン 9.0 には、Kotlin をコンパイルするための組み込みサポートが含まれており、個別に適用された Kotlin プラグインが置き換えられます。これにより、AGP との統合が簡素化され、非推奨の API の使用が回避され、場合によってはパフォーマンスが向上します。

Android Gradle プラグイン 9.0 には、Kotlin Gradle プラグイン 2.2.10 のランタイム依存関係があります。これは、Kotlin の組み込みサポートに必要な最小バージョンです。

AGP 9.0 に Kotlin が組み込まれたことで、test-fixtures の Android Studio IDE のサポートが完全になりました。これを試すには、AGP 9.0.0-alpha07 以降を使用します。

android.builtInKotlin=false を設定すると、組み込みの Kotlin をオプトアウトできます。

組み込みの Kotlin をオプトアウトし、古いバージョンの Kotlin Gradle プラグインを使用する必要がある場合は、ダウングレードを強制できます。

buildscript {
    dependencies {
        classpath("org.jetbrains.kotlin:kotlin-gradle-plugin") {
            version { strictly("2.0.0") } // or another version that you want to use
        }
    }
}

動作の変更

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

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

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 レポートタスク

変更された DSL

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

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

  これ自体は、将来のソースレベルの破壊的変更を回避するためのソースレベルの破壊的変更にすぎませんが、ブロック メソッドを CommonExtension から ApplicationExtension、LibraryExension、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 でのみ使用されていましたが、非推奨になりました。

削除された 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 にアップグレードされません。

修正された問題

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