Versionshinweise zum Android-Gradle-Plug-in 8.11

Das JCenter-Repository wurde am 31. März 2021 schreibgeschützt. Weitere Informationen finden Sie unter JCenter service update.

Das Android Studio-Build-System basiert auf Gradle. Das Android Gradle-Plug-in bietet mehrere Funktionen, die speziell für das Erstellen von Android-Apps entwickelt wurden. Das Android Gradle-Plug-in (AGP) wird in der Regel gleichzeitig mit Android Studio aktualisiert. Das Plug-in (und der Rest des Gradle-Systems) kann jedoch unabhängig von Android Studio ausgeführt und separat aktualisiert werden.

Auf dieser Seite wird beschrieben, wie Sie Ihre Gradle-Tools auf dem neuesten Stand halten und was in den letzten Updates enthalten ist. Die Versionshinweise für frühere Versionen des Android-Gradle-Plug-ins finden Sie hier.

Hier finden Sie eine Liste der behobenen Probleme in dieser Version des Android-Gradle-Plug-ins.

Eine allgemeine Zusammenfassung der anstehenden wichtigen Änderungen im Android-Gradle-Plug-in finden Sie in der Roadmap für das Android-Gradle-Plug-in.

Weitere Informationen zum Konfigurieren Ihrer Android-Builds mit Gradle finden Sie auf den folgenden Seiten:

Weitere Informationen zum Gradle-Buildsystem finden Sie im Gradle-Nutzerhandbuch.

Android-Gradle-Plug-in aktualisieren

Wenn Sie Android Studio aktualisieren, werden Sie möglicherweise aufgefordert, das Android-Gradle-Plug-in automatisch auf die neueste verfügbare Version zu aktualisieren. Sie können das Update akzeptieren oder manuell eine Version angeben, die den Build-Anforderungen Ihres Projekts entspricht.

Sie können die Plugin-Version entweder in Android Studio im Menü File > Project Structure > Project oder in der build.gradle.kts-Datei auf oberster Ebene angeben. Die Plug-in-Version gilt für alle Module, die in diesem Android Studio-Projekt erstellt werden. Im folgenden Beispiel wird das Plug-in in der Datei build.gradle.kts auf Version 8.11.0 festgelegt:

Kotlin

plugins {
    id("com.android.application") version "8.11.0" apply false
    id("com.android.library") version "8.11.0" apply false
    id("org.jetbrains.kotlin.android") version "2.1.20" apply false
}

Groovy

plugins {
    id 'com.android.application' version '8.11.0' apply false
    id 'com.android.library' version '8.11.0' apply false
    id 'org.jetbrains.kotlin.android' version '2.1.20' apply false
}

Achtung:Sie sollten keine dynamischen Abhängigkeiten in Versionsnummern verwenden, z. B. 'com.android.tools.build:gradle:8.11.+'. Die Verwendung dieser Funktion kann zu unerwarteten Versionsaktualisierungen führen und es kann schwierig sein, Versionsunterschiede zu beheben.

Wenn die angegebene Plug-in-Version noch nicht heruntergeladen wurde, lädt Gradle sie beim nächsten Build Ihres Projekts oder wenn Sie in der Menüleiste von Android Studio auf File > Sync Project with Gradle Files klicken.

Gradle aktualisieren

Wenn Sie Android Studio aktualisieren, werden Sie möglicherweise aufgefordert, auch Gradle auf die neueste verfügbare Version zu aktualisieren. Sie können das Update akzeptieren oder manuell eine Version angeben, die den Build-Anforderungen Ihres Projekts entspricht.

In der folgenden Tabelle ist aufgeführt, welche Version von Gradle für die einzelnen Versionen des Android-Gradle-Plug-ins erforderlich ist. Für eine optimale Leistung sollten Sie die jeweils neueste Version von Gradle und des Plug-ins verwenden.

Plug-in-VersionErforderliche Mindestversion von Gradle
8.118.13
8.108.11.1
8.98.11.1
8.88.10.2
8.78.9
8.68.7
8.58.7
8,48.6
8,38,4
8.28.2
8.18.0
8.08.0

Ältere Versionen

Plug-in-VersionErforderliche Gradle-Version
7.47,5
7.37.4
7,27.3.3
7.17,2
77
4.2.0+6.7.1
4.1.0+6.5+
4.0.0+6.1.1+
3.6.0 – 3.6.45.6.4+
3.5.0 – 3.5.45.4.1+
3.4.0 – 3.4.35.1.1+
3.3.0 – 3.3.34.10.1+
3.2.0 – 3.2.14.6+
3.1.0+4.4+
3.0.0+4.1+
2.3.0+3.3+
2.1.3 – 2.2.32.14.1 – 3.5
2.0.0 – 2.1.22.10 – 2.13
1.5.02.2.1 – 2.13
1.2.0 – 1.3.12.2.1 – 2.9
1.0.0 – 1.1.32.2.1 – 2.3

Sie können die Gradle-Version entweder in Android Studio über das Menü File > Project Structure > Project angeben oder die Gradle-Version über die Befehlszeile aktualisieren. Die bevorzugte Methode ist die Verwendung des Gradle Wrapper-Befehlszeilentools, mit dem die gradlew-Skripts aktualisiert werden. Im folgenden Beispiel wird die Gradle-Version mit dem Gradle-Wrapper auf 8.13 festgelegt. Hinweis: Sie müssen diesen Befehl zweimal ausführen, um sowohl Gradle als auch den Gradle-Wrapper selbst zu aktualisieren. Weitere Informationen finden Sie unter Gradle-Wrapper aktualisieren.

gradle wrapper --gradle-version 8.13

Das kann jedoch in einigen Fällen fehlschlagen, z. B. wenn Sie AGP gerade aktualisiert haben und es nicht mehr mit der aktuellen Gradle-Version kompatibel ist. In diesem Fall müssen Sie den Gradle-Verteilungsverweis in der Datei gradle/wrapper/gradle-wrapper.properties bearbeiten. Im folgenden Beispiel wird die Gradle-Version in der Datei gradle-wrapper.properties auf 8.13 festgelegt.

...
distributionUrl = https\://services.gradle.org/distributions/gradle-8.13-bin.zip
...

Kompatibilität zwischen Android-Gradle-Plug-in und Android Studio

Das Android Studio-Build-System basiert auf Gradle. Das Android Gradle-Plug-in (AGP) bietet mehrere Funktionen, die speziell für das Erstellen von Android-Apps entwickelt wurden. In der folgenden Tabelle ist aufgeführt, welche Version von AGP für jede Version von Android Studio erforderlich ist.

Android Studio-Version Erforderliche AGP-Version
Narwhal Feature Drop | 2025.1.2 4.0-8.12
Narwhal | 2025.1.1 3.2-8.11
Meerkat Feature Drop | 2024.3.2 3.2-8.10
Erdmännchen | 2024.3.1 3.2-8.9
Ladybug Feature Drop | 2024.2.2 3.2–8.8
Ladybug | 2024.2.1 3,2–8,7
Koala Feature Drop | 2024.1.2 3,2–8,6
Koala | 2024.1.1 3.2-8.5
Jellyfish | 2023.3.1 3.2-8.4
Iguana | 2023.2.1 3.2-8.3
Hedgehog | 2023.1.1 3.2-8.2
Giraffe | 2022.3.1 3.2-8.1
Flamingo | 2022.2.1 3.2–8.0

Ältere Versionen

Android Studio-Version Erforderliche AGP-Version
Electric Eel | 2022.1.1 3.2-7.4
Dolphin | 2021.3.1 3.2-7.3
Chipmunk | 2021.2.1 3.2-7.2
Bumblebee | 2021.1.1 3.2–7.1
Arctic Fox | 2020.3.1 3.1–7.0

Informationen zu den Neuerungen im Android-Gradle-Plug-in finden Sie in den Versionshinweisen zum Android-Gradle-Plug-in.

Mindestversionen von Tools für Android-API‑Level

Für ein bestimmtes API-Level sind Mindestversionen von Android Studio und AGP erforderlich. Wenn Sie niedrigere Versionen von Android Studio oder AGP verwenden, als für das targetSdk oder compileSdk Ihres Projekts erforderlich sind, kann das zu unerwarteten Problemen führen. Wir empfehlen, die aktuelle Vorabversion von Android Studio und AGP für Projekte zu verwenden, die auf Vorabversionen des Android-Betriebssystems ausgerichtet sind. Sie können Vorschaubersionen von Android Studio neben einer stabilen Version installieren.

Die Mindestversionen von Android Studio und AGP sind:

API-Ebene Mindestversion von Android Studio AGP-Mindestversion
36,0 Erdmännchen | 2024.3.1 Patch 1 8.9.1
35 Koala Feature Drop | 2024.2.1 8.6.0
34 Hedgehog | 2023.1.1 8.1.1
33 Flamingo | 2022.2.1 7,2

Änderungen bei der Versionsverwaltung (November 2020)

Wir aktualisieren die Versionsnummerierung für das Android-Gradle-Plug-in (AGP), damit sie besser mit dem zugrunde liegenden Gradle-Build-Tool übereinstimmt.

Hier sind die wichtigsten Änderungen:

  • AGP verwendet jetzt die semantische Versionsverwaltung und funktionsgefährdende Änderungen werden für Hauptversionen vorgesehen.

  • Es wird pro Jahr eine Hauptversion von AGP veröffentlicht, die auf das Haupt-Release von Gradle abgestimmt ist.

  • Die Version nach AGP 4.2 ist Version 7.0. Für diese ist ein Upgrade auf Gradle-Version 7.x erforderlich. Für jede Hauptversion von AGP ist ein Upgrade der Hauptversion des zugrunde liegenden Gradle-Tools erforderlich.

  • APIs werden etwa ein Jahr im Voraus eingestellt. Gleichzeitig werden Ersatzfunktionen zur Verfügung gestellt. Verworfene APIs werden etwa ein Jahr später beim nächsten Hauptupdate entfernt.

Kompatibilität

Das maximale API-Level, das vom Android-Gradle-Plugin 8.11 unterstützt wird, ist API-Level 36. Weitere Informationen zur Kompatibilität:

Mindestversion Standardversio Hinweise
Gradle 8.13 8.13 Weitere Informationen finden Sie unter Gradle aktualisieren.
SDK-Build-Tools 35.0.0 35.0.0 Installieren oder Konfigurieren Sie die SDK-Build-Tools.
NDK 27.0.12077973 Installieren oder konfigurieren Sie eine andere Version des NDK.
JDK 17 17 Weitere Informationen finden Sie unter JDK-Version festlegen.

Behobene Probleme

Android-Gradle-Plug-in 8.11.0

Behobene Probleme
Android-Gradle-Plug-in
Isoliertes Projekt: Fehler bei der Serialisierung von „DeclarativeSchemaModel“
Anfrage: Erkläre, warum „zipAlignEnabled“ eingestellt wurde und was stattdessen verwendet werden soll.
[AGP 8.9.0+] BuiltinKotlinCompilation für alle Kotlin-Compiler-Plug-ins verfügbar
Kotlin-Abhängigkeiten beim Erstellen von AGP 8.11 auf Version 2.1.20 aktualisieren
com.android.internal.version-check beim Aktualisieren der Gradle-Distribution nicht erzwingen
Build schlägt fehl, wenn die ProGuard-Datei nicht vorhanden ist
Dexer (D8)
AutoClosable-Desugaring führt zu AGP-Builds in Android Studio
Lint
Die Lint-Regel „BuildListAdds“ erkennt die Verwendung der Operatorfunktion „plusAssign“ (+=) in „buildList“ nicht.
Falsch positive Ergebnisse mit „UseSdkSuppress“ in Test-Helper-Code unterdrücken
Warnung vor potenziellen Konflikten zwischen Mitglied und Erweiterung
Falsch-positiver Befund für das Lint-Problem „MemberExtensionConflict“, wenn der Empfänger der Erweiterungsfunktion nullable ist
Falsch positives Ergebnis bei der Prüfung `WrongGradleMedthod`
Falsch-positiver „SyntheticAccessor“ für den Aufruf des synthetischen Mitglieds der Datenklasse
TestMode.SUPPRESSIBLE-Fehler für Problem, das für kennzeichnungsfähigen Ausdruck gemeldet wurde
Neue MemberExtensionConflict-Lint-Probleme ab AGP 8.11.0-alpha03 – wie lassen sie sich beheben?
Die Lint-Prüfung in der Datei „libs.versions.toml“ schlägt ein Upgrade auf eine nicht unterstützte AGP-Version vor.
Shrinker (R8)
Signiertes AAB kann nach dem Update auf AGP 8.9.0 nicht generiert werden
R8 stürzt bei der Verarbeitung von JavaFuzzer-Code mit min-api 24 ab