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:
- Build konfigurieren
- Android Gradle-Plug-in – DSL-Referenz
- Gradle DSL-Referenz
- Nutzerhandbuch zur Gradle-Leistung
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-Version | Erforderliche Mindestversion von Gradle |
|---|---|
| 8.11 | 8.13 |
| 8.10 | 8.11.1 |
| 8.9 | 8.11.1 |
| 8.8 | 8.10.2 |
| 8.7 | 8.9 |
| 8.6 | 8.7 |
| 8.5 | 8.7 |
| 8,4 | 8.6 |
| 8,3 | 8,4 |
| 8.2 | 8.2 |
| 8.1 | 8.0 |
| 8.0 | 8.0 |
Ältere Versionen
| Plug-in-Version | Erforderliche Gradle-Version |
|---|---|
| 7.4 | 7,5 |
| 7.3 | 7.4 |
| 7,2 | 7.3.3 |
| 7.1 | 7,2 |
| 7 | 7 |
| 4.2.0+ | 6.7.1 |
| 4.1.0+ | 6.5+ |
| 4.0.0+ | 6.1.1+ |
| 3.6.0 – 3.6.4 | 5.6.4+ |
| 3.5.0 – 3.5.4 | 5.4.1+ |
| 3.4.0 – 3.4.3 | 5.1.1+ |
| 3.3.0 – 3.3.3 | 4.10.1+ |
| 3.2.0 – 3.2.1 | 4.6+ |
| 3.1.0+ | 4.4+ |
| 3.0.0+ | 4.1+ |
| 2.3.0+ | 3.3+ |
| 2.1.3 – 2.2.3 | 2.14.1 – 3.5 |
| 2.0.0 – 2.1.2 | 2.10 – 2.13 |
| 1.5.0 | 2.2.1 – 2.13 |
| 1.2.0 – 1.3.1 | 2.2.1 – 2.9 |
| 1.0.0 – 1.1.3 | 2.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 |
|
|||||||||
| Dexer (D8) |
|
|||||||||
| Lint |
|
|||||||||
| Shrinker (R8) |
|
|||||||||