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

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

Android Gradle プラグイン 9.0

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

Android Gradle プラグイン 9.0.0-alpha04 に更新するには、Android Studio Narwhal 4 Feature Drop | 2025.1.4 の Android Gradle プラグイン Upgrade Assistant を使用します。

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

互換性

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

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

内部 DSL 実装と非推奨の Variant API で明示的なオプトインが必要に

Android Gradle プラグインに API サーフェスが定義され、サポートされている API が com.android.tools.build:gradle-api Maven アーティファクトで定義されるようになりました。

既存のバイナリ プラグインやビルド スクリプトとの互換性を維持するため、定義された API サーフェスより前の以前の DSL 実装は、AGP 8.13 以前ではデフォルトで公開されていました。これにより、Gradle プラグインとビルドスクリプトのコードは、DSL の内部実装の詳細と、非推奨の android.applicationVariants、android.libraryVariants、android.testVariants、android.unitTestVariants API の両方にアクセスできます。これらの API は、AGP 10 の 2026 年に削除されます。

この移行をより明確にするため、Android Gradle プラグイン 9.0.0-alpha04 では、以前のバリアント API と内部 DSL の両方がデフォルトでアクセスできなくなっています。

gradle.properties で android.newDsl=false を設定すると、非推奨の API を再び使用できます。

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

Kotlin が組み込まれている

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

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

組み込みの Kotlin をオプトアウトするには、android.builtInKotlin=false を設定します。オプトアウトしていて、古いバージョンの 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 {
    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 のパラメータ化が削除されました。これ自体は、将来のソースレベルの破壊的変更を回避するためのソースレベルの破壊的変更にすぎませんが、DSL ブロック メソッドを CommonExtension から ApplicationExtension、LibraryExension、DynamicFeatureExtension、TestExtension に移動する必要があることも意味します。

DSL を削除しました

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

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

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

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

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

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

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

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

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

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

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

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

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

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

削除された Gradle プロパティ

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

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

android {
  buildFeatures {
    aidl = true
  }
}

android {
  buildFeatures {
    renderScript = true
  }
}

削除された API

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

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

適用される Gradle プロパティ

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

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