Versionshinweise für die Vorabversion des Android-Gradle-Plug-ins

Auf dieser Seite finden Sie Versionshinweise für Vorabversionen des Android-Gradle-Plug-ins (AGP).

Android-Gradle-Plug-in 9.0

Das Android-Gradle-Plug-in 9.0 ist ein neuer Hauptrelease von AGP und bringt API- und Verhaltensänderungen mit sich.

Wenn Sie auf das Android Gradle-Plug-in 9.0.0-beta04 aktualisieren möchten, verwenden Sie den Android-Gradle-Plug-in-Upgrade-Assistenten in Android Studio Otter 3 Feature Drop | 2025.2.3.

Der AGP-Upgrade-Assistent hilft dabei, vorhandene Verhaltensweisen beim Upgrade Ihres Projekts beizubehalten, sofern dies angemessen ist. So können Sie Ihr Projekt auf AGP 9.0 aktualisieren, auch wenn Sie noch nicht bereit sind, alle neuen Standardeinstellungen in AGP 9.0 zu übernehmen.

Kompatibilität

Das maximale Android-API-Level, das vom Android-Gradle-Plug-in 9.0.0-beta04 unterstützt wird, ist API-Level 36.

Für das Android-Gradle-Plug-in 9.0.0-beta04 ist Gradle 9.0.0 erforderlich.

Die android-DSL-Klassen implementieren jetzt nur noch die neuen öffentlichen Schnittstellen.

In den letzten Jahren haben wir neue Schnittstellen für unsere DSL und API eingeführt, um besser steuern zu können, welche APIs öffentlich sind. In AGP-Versionen 7.x und 8.x wurden weiterhin die alten DSL-Typen (z. B. BaseExtension) verwendet, in denen auch die neuen öffentlichen Schnittstellen implementiert wurden, um die Kompatibilität während der Entwicklung der Schnittstellen aufrechtzuerhalten.

AGP 9.0 verwendet ausschließlich unsere neuen DSL-Schnittstellen und die Implementierungen wurden in neue, vollständig verborgene Typen geändert. Dadurch wird auch der Zugriff auf die alte, eingestellte Variant API entfernt.

Für das Update auf AGP 9.0 müssen Sie möglicherweise Folgendes tun:

• Prüfen, ob Ihr Projekt mit integriertem Kotlin kompatibel ist:Das org.jetbrains.kotlin.android-Plug-in ist nicht mit der neuen DSL kompatibel.

• KMP-Projekte auf das Android Gradle Library-Plug-in für KMP umstellen:Die Verwendung des org.jetbrains.kotlin.multiplatform-Plug-ins im selben Gradle-Unterprojekt wie die com.android.library- und com.android.application-Plug-ins ist nicht mit der neuen DSL kompatibel.

• Build-Dateien aktualisieren:Obwohl die Änderung der Schnittstellen darauf abzielt, die DSL so ähnlich wie möglich zu halten, kann es einige kleine Änderungen geben.

• Benutzerdefinierte Build-Logik aktualisieren, um auf die neue DSL und API zu verweisen:Ersetzen Sie alle Verweise auf die interne DSL durch die öffentlichen DSL-Schnittstellen. In den meisten Fällen handelt es sich um einen direkten Ersatz. Ersetzen Sie alle Verwendungen der applicationVariants- und ähnlicher APIs durch die neue androidComponents-API. Das kann komplexer sein, da die androidComponents API stabiler konzipiert ist, damit Plugins länger kompatibel bleiben. Beispiele finden Sie in unseren Gradle-Rezepten.

• Drittanbieter-Plug-ins aktualisieren:Einige Drittanbieter-Plug-ins sind möglicherweise weiterhin von Schnittstellen oder APIs abhängig, die nicht mehr verfügbar sind. Migrieren Sie zu Versionen dieser Plug-ins, die mit AGP 9.0 kompatibel sind.

Durch die Umstellung auf die neuen DSL-Schnittstellen werden Plug-ins und Gradle-Build-Skripts, die verschiedene eingestellte APIs verwenden, verhindert, darunter:

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

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

Wenn Sie auf AGP 9.0 aktualisieren und die folgende Fehlermeldung angezeigt wird, bedeutet das, dass in Ihrem Projekt weiterhin auf einige der alten Typen verwiesen wird:

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

Wenn Sie durch inkompatible Drittanbieter-Plug-ins blockiert werden, können Sie die alten Implementierungen für die DSL sowie die alte Variant API wiederherstellen. Die neuen Schnittstellen sind dabei ebenfalls verfügbar und Sie können Ihre eigene Build-Logik weiterhin auf die neue API umstellen. Fügen Sie diese Zeile in Ihre gradle.properties-Datei ein, um die Speicherung zu verhindern:

android.newDsl=false

Sie können auch mit dem Upgrade auf die neuen APIs beginnen, bevor Sie auf AGP 9.0 upgraden. Die neuen Schnittstellen sind seit vielen AGP-Versionen verfügbar, sodass Sie neue und alte Schnittstellen mischen können. In der AGP-API-Referenzdokumentation wird die API-Oberfläche für jede AGP-Version angezeigt. Außerdem ist dort angegeben, wann jede Klasse, Methode und jedes Feld hinzugefügt wurde.

Während der Alpha-Phase von Version 9.0 werden wir uns an Plug-in-Autoren wenden, um ihnen bei der Anpassung und Veröffentlichung von Plug-ins zu helfen, die vollständig mit den neuen Modi kompatibel sind. Außerdem werden wir den AGP-Upgrade-Assistenten in Android Studio verbessern, um Sie bei der Migration zu unterstützen.

Wenn Sie feststellen, dass in der neuen DSL- oder Variant-API Funktionen fehlen, melden Sie das Problem bitte so bald wie möglich.

Integriertes Kotlin

Das Android-Gradle-Plug-in 9.0 bietet integrierte Kotlin-Unterstützung, die standardmäßig aktiviert ist. Das bedeutet, dass Sie das org.jetbrains.kotlin.android-Plug-in (oder kotlin-android-Plug-in) nicht mehr in Ihren Build-Dateien anwenden müssen, um Kotlin-Quelldateien zu kompilieren. Dadurch wird die Kotlin-Integration mit AGP vereinfacht, die Verwendung von eingestellten APIs vermieden und die Leistung in einigen Fällen verbessert.

Wenn Sie Ihr Projekt auf AGP 9.0 aktualisieren, müssen Sie daher auch zur integrierten Kotlin-Unterstützung migrieren oder die integrierte Kotlin-Unterstützung deaktivieren.

Sie können die integrierte Kotlin-Unterstützung auch selektiv für Gradle-Unterprojekte deaktivieren, die keine Kotlin-Quellen haben.

Laufzeitabhängigkeit vom Kotlin-Gradle-Plug-in

Um integrierte Kotlin-Unterstützung zu bieten, hat das Android-Gradle-Plug-in 9.0 jetzt eine Laufzeitabhängigkeit vom Kotlin-Gradle-Plug-in (KGP) 2.2.10. Das bedeutet, dass Sie keine KGP-Version mehr deklarieren müssen. Wenn Sie eine KGP-Version unter 2.2.10 verwenden, wird Ihre KGP-Version automatisch auf 2.2.10 aktualisiert. Wenn Sie eine KSP-Version verwenden, die niedriger als 2.2.10-2.0.2 ist, wird sie von AGP auf 2.2.10-2.0.2 aktualisiert, damit sie mit der KGP-Version übereinstimmt.

Upgrade auf eine höhere KGP-Version

Wenn Sie eine höhere Version von KGP oder KSP verwenden möchten, fügen Sie Folgendes in die Build-Datei der obersten Ebene ein:

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")
    }
}

Downgrade auf eine niedrigere KGP-Version

Sie können die KGP-Version nur downgraden, wenn Sie integriertes Kotlin deaktiviert haben. Das liegt daran, dass in AGP 9.0 standardmäßig integriertes Kotlin aktiviert ist und für integriertes Kotlin KGP 2.2.10 oder höher erforderlich ist.

Wenn Sie eine niedrigere Version von KGP oder KSP verwenden möchten, deklarieren Sie diese Version in Ihrer Build-Datei der obersten Ebene mit einer Deklaration für die strikte Version:

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") }
        }
    }
}

Die niedrigste KGP-Version, auf die Sie ein Downgrade durchführen können, ist 2.0.0.

IDE-Unterstützung für Test-Fixtures

AGP 9.0 bietet vollständige Unterstützung für Test-Fixtures in der Android Studio IDE.

Fused Library-Plug-in

Mit dem Fused Library-Plug-in (Vorschau) können Sie mehrere Bibliotheken als einzelne Android-Bibliothek (AAR) veröffentlichen. Das kann es Nutzern erleichtern, sich auf Ihre veröffentlichten Artefakte zu verlassen.

Informationen zu den ersten Schritten finden Sie unter Mehrere Android-Bibliotheken als eine mit Fused Library veröffentlichen.

Verhaltensänderungen

Das Android-Gradle-Plug-in 9.0 hat die folgenden neuen Verhaltensweisen:

AGP 9.0 enthält Aktualisierungen der Standardwerte der folgenden Gradle-Attribute. So haben Sie die Möglichkeit, das Verhalten von AGP 8.13 beim Upgrade beizubehalten:

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

android {
  buildFeatures {
    resValues = true
  }
}

android {
  buildFeatures {
    shaders = true
  }
}

Entfernte Funktionen

Im Android-Gradle-Plug-in 9.0 wurden die folgenden Funktionen entfernt:

• Unterstützung für eingebettete Wear OS-Apps
  In AGP 9.0 wird die Unterstützung für das Einbetten von Wear OS-Apps entfernt, da dies in Play nicht mehr unterstützt wird. Dazu gehört das Entfernen der wearApp-Konfigurationen und der AndroidSourceSet.wearAppConfigurationName-DSL. Informationen zum Veröffentlichen Ihrer App für Wear OS finden Sie unter Über Wear OS verbreiten.
• androidDependencies- und sourceSets-Berichtsaufgabe
• Unterstützung für dichtebasierte unterteilte APKs
  In AGP 9.0 wird die Unterstützung für die Erstellung von unterteilten APKs basierend auf der Bildschirmdichte entfernt. Die Funktion und die zugehörigen APIs wurden entfernt. Wenn Sie APKs mit AGP 9.0 oder höher basierend auf der Bildschirmdichte aufteilen möchten, verwenden Sie App-Bundles.

Geänderte DSL

Das Android-Gradle-Plug-in 9.0 enthält die folgenden wichtigen DSL-Änderungen:

• Die Parametrisierung von CommonExtension wurde entfernt.

  An sich ist dies nur eine funktionsgefährdende Änderung auf Quellcodeebene, um zukünftige funktionsgefährdende Änderungen auf Quellcodeebene zu vermeiden. Sie bedeutet aber auch, dass die Blockmethoden von CommonExtension zu ApplicationExtension, LibraryExtension, DynamicFeatureExtension und TestExtension verschoben werden müssen.

  Wenn Sie Ihr Projekt auf AGP 9.0 aktualisieren, müssen Sie den Gradle-Plug-in-Code umgestalten, in dem diese Parameter oder die Blockmethoden verwendet werden. Das folgende Beispiel zeigt, wie ein Plug-in aktualisiert wird, um den Typparameter zu entfernen und nicht auf die entfernten Blockmethoden zu verweisen:

  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)
          }
      }
  }
  

  Bei Plug-ins, die auf einen Bereich von AGP-Versionen ausgerichtet sind, ist die direkte Verwendung des Getters binärkompatibel mit AGP-Versionen unter 9.0.

Entfernte DSL

Im Android-Gradle-Plug-in 9.0 wurden folgende Elemente entfernt:

• AndroidSourceSet.jni, da es nicht funktionsfähig war.

• AndroidSourceSet.wearAppConfigurationName, da die Unterstützung für eingebettete Wear OS-Apps entfernt wurde.

• BuildType.isRenderscriptDebuggable, da es nicht funktionsfähig war.

• DependencyVariantSelection. Es wird durch DependencySelection ersetzt, das als kotlin.android.localDependencySelection verfügbar ist.

• Installation.installOptions(String). Es wird durch das veränderliche Attribut von Installation.installOptions ersetzt.

• Der experimentelle, aber nie stabilisierte PostProcessing-Block.

• ProductFlavor.setDimension, das durch das Attribut dimension ersetzt wird

• LanguageSplitOptions, das nur für Google Play Instant nützlich war, das eingestellt wurde.

• DensitySplit, da die Funktion nicht mehr unterstützt wird. Als Ersatz können Sie App Bundles verwenden.

Entfernte APIs

Im Android-Gradle-Plug-in 9.0 wurden folgende Elemente entfernt:

• AndroidComponentsExtension.finalizeDSl. Es wird durch finalizeDsl ersetzt.

• Component.transformClassesWith. Es wird durch Instrumentation.transformClassesWith ersetzt.

• Component.setAsmFramesComputationMode. Es wird durch Instrumentation.setAsmFramesComputationMode ersetzt.

• ComponentBuilder.enabled. Es wird durch ComponentBuilder.enable ersetzt.

• DependenciesInfoBuilder.includedInApk. Es wird durch includeInApk ersetzt.

• DependenciesInfoBuilder.includedInBundle. Es wird durch includeInBundle ersetzt.

• GeneratesApk.targetSdkVersion. Es wird durch targetSdk ersetzt.

• Variant.minSdkVersion. Es wird durch minSdk ersetzt.

• Variant.maxSdkVersion. Es wird durch maxSdk ersetzt.

• Variant.targetSdkVersion. Es wird durch targetSdk ersetzt.

• Variant.unitTest, da sie nicht für das com.android.test-Plug-in gilt. unitTest ist für VariantBuilder-Untertypen verfügbar, die HasUnitTest erweitern.

• VariantBuilder.targetSdk und targetSdkPreview, da sie in Bibliotheken nicht sinnvoll waren. Verwenden Sie stattdessen GeneratesApkBuilder.targetSdk oder GeneratesApkBuilder.targetSdkPreview.

• VariantBuilder.enableUnitTest, da sie nicht für das com.android.test-Plug-in gilt. enableUnitTest ist für VariantBuilder-Untertypen verfügbar, die HasUnitTestBuilder erweitern.

• VariantBuilder.unitTestEnabled wird zugunsten von enableUnitTest entfernt, das in den Untertypen von VariantBuilder, die HasUnitTestBuilder erweitern, einheitlicher benannt ist.

• VariantOutput.enable. Es wird durch enabled ersetzt.

• Die verworfenen und deaktivierten FeaturePlugin und FeatureExtension.

• Die eingestellten und deaktivierten BaseExtension.registerTransform APIs, die nur noch vorhanden waren, um die Kompilierung mit der neuesten AGP-Version zu ermöglichen, während die Ausführung auf AGP 4.2 oder niedriger erfolgte.

Entfernte Gradle-Eigenschaften

Die folgenden Gradle-Properties wurden ursprünglich hinzugefügt, um Funktionen, die standardmäßig aktiviert waren, global zu deaktivieren.

Diese Funktionen sind seit AGP 8.0 oder niedriger standardmäßig deaktiviert. Aktivieren Sie diese Funktionen nur in den Unterprojekten, in denen sie verwendet werden, um einen effizienteren Build zu ermöglichen.

android {
  buildFeatures {
    aidl = true
  }
}

android {
  buildFeatures {
    renderScript = true
  }
}

Erzwungene Gradle-Properties

In AGP 9.0 wird ein Fehler ausgegeben, wenn Sie die folgenden Gradle-Attribute festlegen.

Der Android-Gradle-Plug-in-Upgrade-Assistent aktualisiert Projekte, in denen diese Attribute verwendet werden, nicht auf AGP 9.0.

Behobene Probleme

Android-Gradle-Plug-in 9.0.0-beta04

Android-Gradle-Plug-in 9.0.0-beta03

Android-Gradle-Plug-in 9.0.0-beta02

Android-Gradle-Plug-in 9.0.0-beta01

Android-Gradle-Plug-in 9.0.0-alpha14

Android-Gradle-Plug-in 9.0.0-alpha13

Android-Gradle-Plug-in 9.0.0-alpha12

Android-Gradle-Plug-in 9.0.0-alpha11

Android-Gradle-Plug-in 9.0.0-alpha10

Android-Gradle-Plug-in 9.0.0-alpha09

Android-Gradle-Plug-in 9.0.0-alpha08

Android-Gradle-Plug-in 9.0.0-alpha07

Android-Gradle-Plug-in 9.0.0-alpha06

Android-Gradle-Plug-in 9.0.0-alpha05

Android-Gradle-Plug-in 9.0.0-alpha04

Android-Gradle-Plug-in 9.0.0-alpha03

Android-Gradle-Plug-in 9.0.0-alpha02

Android-Gradle-Plug-in 9.0.0-alpha01