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-alpha11 aktualisieren möchten, verwenden Sie den Android-Gradle-Plug-in-Upgrade-Assistenten in Android Studio Otter 2 Feature Drop | 2025.2.2.

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-alpha11 unterstützt wird, ist API-Level 36.

Für das Android-Gradle-Plug-in 9.0.0-alpha11 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.

In AGP 9.0 werden ausschließlich unsere neuen DSL-Schnittstellen verwendet 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 Sie, 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-Bibliotheks-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:Die Änderung der Schnittstellen soll das DSL so ähnlich wie möglich halten. Es kann jedoch 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 auch 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 eine Mischung aus neuen und alten Schnittstellen verwenden können. In der AGP-API-Referenzdokumentation wird die API-Oberfläche für jede AGP-Version angezeigt und es wird 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 schnell wie möglich.

Integriertes Kotlin

Das Android-Gradle-Plug-in 9.0 bietet integrierte Kotlin-Unterstützung und aktiviert diese standardmäßig. Das bedeutet, dass Sie das org.jetbrains.kotlin.android-Plug-in (oder kotlin-android) nicht mehr in Ihren Build-Dateien anwenden müssen, um Kotlin-Quelldateien zu kompilieren. Dadurch wird die Kotlin-Integration mit AGP vereinfacht, die Verwendung der 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 für Gradle-Unterprojekte ohne Kotlin-Quellen selektiv deaktivieren.

Laufzeitabhängigkeit vom Kotlin-Gradle-Plug-in 2.2.10

Das Android-Gradle-Plug-in 9.0 hat eine Laufzeitabhängigkeit vom Kotlin-Gradle-Plug-in (KGP) 2.2.10. Dies ist die Mindestversion, die für die integrierte Kotlin-Unterstützung erforderlich ist.

Wenn Sie sich für die integrierte Kotlin-Unterstützung entscheiden und eine KGP-Version unter 2.2.10 verwenden, führt Gradle automatisch ein Upgrade auf KGP-Version 2.2.10 durch.

Wenn Sie eine KSP-Version unter 2.2.10-2.0.2 verwenden, wird die KSP-Version von AGP auf 2.2.10-2.0.2 aktualisiert, damit sie mit der KGP-Version übereinstimmt.

Wenn Sie die integrierte Kotlin-Unterstützung deaktivieren und eine ältere Version von KGP oder KSP verwenden möchten, müssen Sie Ihrer Build-Datei auf oberster Ebene Folgendes hinzufügen:

buildscript {
    dependencies {
        classpath("org.jetbrains.kotlin:kotlin-gradle-plugin") {
            version { strictly("KGP_VERSION") }
        }
        classpath("com.google.devtoolsksp:symbol-processing-gradle-plugin") {
            version { strictly("KSP_VERSION") }
        }
    }
}

IDE-Unterstützung für Test-Fixtures

AGP 9.0 bietet vollständige Android Studio IDE-Unterstützung für Test-Fixtures. Verwenden Sie AGP 9.0.0-alpha07 oder höher, um diese Unterstützung zu erhalten.

Geändertes Verhalten

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 {
  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
  Mit 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

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, LibraryExension, 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 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.

DSL entfernt

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

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

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

• BuildType.isRenderscriptDebuggable, da sie 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.

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 galt. 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 galt. 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-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