Das Build-System von Android Studio basiert auf Gradle und das Android-Gradle-Plug-in bietet mehrere Features zum Erstellen von Android-Apps. Das Android-Gradle-Plug-in (AGP) wird zwar in der Regel im Lockstep mit Android Studio aktualisiert, das Plug-in (und der Rest des Gradle-Systems) können jedoch unabhängig von Android Studio ausgeführt und separat aktualisiert werden.
Auf dieser Seite erfahren Sie, wie Sie Ihre Gradle-Tools auf dem neuesten Stand halten und was sich in den neuesten Updates befindet. Versionshinweise für frühere Versionen des Android-Gradle-Plug-ins finden Sie unter Frühere Versionshinweise.
Welche Probleme in dieser Version des Android-Gradle-Plug-ins behoben wurden, erfahren Sie hier.
Eine allgemeine Zusammenfassung der anstehenden funktionsgefährdenden Ä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
- DSL-Referenz zum Android-Gradle-Plug-in
- Gradle DSL-Referenz
- Nutzerhandbuch zur Gradle-Leistung
Weitere Informationen zum Gradle-Build-System 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 übernehmen oder manuell eine Version basierend auf den Build-Anforderungen Ihres Projekts angeben.
Sie können die Plug-in-Version in Android Studio entweder im Menü Datei > Projektstruktur > Projekt oder in der Datei build.gradle.kts
auf oberster Ebene angeben. Die Plug-in-Version gilt für alle Module, die in diesem Android Studio-Projekt integriert sind. Im folgenden Beispiel wird das Plug-in aus der Datei build.gradle.kts
auf Version 8.5.0 festgelegt:
Kotlin
plugins { id("com.android.application") version "8.5.0" apply false id("com.android.library") version "8.5.0" apply false id("org.jetbrains.kotlin.android") version "1.9.23" apply false }
Cool
plugins { id 'com.android.application' version '8.5.0' apply false id 'com.android.library' version '8.5.0' apply false id 'org.jetbrains.kotlin.android' version '1.9.23' apply false }
Achtung: Verwenden Sie in Versionsnummern keine dynamischen Abhängigkeiten wie 'com.android.tools.build:gradle:8.5.+'
.
Die Verwendung dieser Funktion kann zu unerwarteten Versionsupdates und Schwierigkeiten beim Beheben von Versionsunterschieden führen.
Wenn die angegebene Plug-in-Version nicht heruntergeladen wurde, lädt Gradle sie herunter, wenn Sie das nächste Mal Ihr Projekt erstellen, oder klicken Sie in der Android Studio-Menüleiste auf File > Sync Project with Gradle Files.
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 übernehmen oder manuell eine Version basierend auf den Build-Anforderungen Ihres Projekts angeben.
In der folgenden Tabelle ist aufgeführt, welche Version von Gradle für die einzelnen Versionen des Android-Gradle-Plug-ins erforderlich ist. Die beste Leistung erzielen Sie, wenn Sie die neueste mögliche Version von Gradle und des Plug-ins verwenden.
Plug-in-Version | Mindestens erforderliche Gradle-Version |
---|---|
8,5 | 8,7 |
8,4 | 8,6 |
8,3 | 8,4 |
8.2 | 8.2 |
8.1 | 8.0 |
8.0 | 8.0 |
7,4 | 7,5 |
Ältere Versionen
Plug-in-Version | Erforderliche Gradle-Version |
---|---|
7,3 | 7,4 |
7,2 | 7.3.3 |
7.1 | 7,2 |
7 | 7 |
4.2.0 und höher | 6.7.1 |
4.1.0 und höher | 6.5 oder höher |
4.0.0 und höher | 6.1.1 und höher |
3.6.0–3.6.4 | 5.6.4 und höher |
3.5.0–3.5.4 | 5.4.1 und höher |
3.4.0–3.4.3 | 5.1.1 und höher |
3.3.0–3.3.3 | 4.10.1 und höher |
3.2.0–3.2.1 | 4.6 und höher |
3.1.0 und höher | 4.4 und höher |
3.0.0 und höher | 4.1 und höher |
2.3.0 und höher | 3.3 und höher |
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 in Android Studio im Menü File > Project Structure > Project angeben oder die Gradle-Version über die Befehlszeile aktualisieren.
In der Regel ist es am besten, das Befehlszeilentool Gradle Wrapper zu verwenden, mit dem die gradlew
-Skripts aktualisiert werden. Im folgenden Beispiel wird die Gradle-Version mithilfe des Gradle-Wrappers auf 8.5 gesetzt.
Sie müssen diesen Befehl zweimal ausführen, um sowohl Gradle als auch den Gradle-Wrapper selbst zu aktualisieren. Weitere Informationen finden Sie unter Upgrade des Gradle-Wrappers.
gradle wrapper --gradle-version 8.5
In einigen Fällen kann dies jedoch 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 die Gradle-Verteilungsreferenz in der Datei gradle/wrapper/gradle-wrapper.properties
bearbeiten. Im folgenden Beispiel wird die Gradle-Version in der Datei gradle-wrapper.properties
auf 8.5 gesetzt.
...
distributionUrl = https\://services.gradle.org/distributions/gradle-8.5-bin.zip
...
Android-Gradle-Plug-in und Kompatibilität mit Android Studio
Das Build-System von Android Studio basiert auf Gradle und das Android-Gradle-Plug-in (AGP) bietet mehrere Funktionen, die speziell für die Erstellung von Android-Apps vorgesehen sind. In der folgenden Tabelle ist aufgeführt, welche AGP-Version für die einzelnen Versionen von Android Studio erforderlich ist.
Android Studio-Version | Erforderliche AGP-Version |
---|---|
Koala | 1.1.2024 | 3,2–8,5 |
Quallen | 1.3.2023 | 3,2–8,4 |
Iguana | 1.2.2023 | 3,2–8,3 |
Igel | 1.1.2023 | 3,2–8,2 |
Giraffe | 1.3.2022 | 3.2–8.1 |
Flamingo | 1.2.2022 | 3,2–8,0 |
Ältere Versionen
Android Studio-Version | Erforderliche AGP-Version |
---|---|
Electric Eel | 1.1.2022 | 3,2–7,4 |
Dolphin | 1.3.2021 | 3,2–7,3 |
Streifenhörnchen | 1.2.2021 | 3.2–7.2 |
Hummel | 1.1.2021 | 3.2–7.1 |
Polarfuchs | 1.3.2020 | 3.1–7.0 |
Informationen zu den Neuerungen im Android-Gradle-Plug-in finden Sie in den Versionshinweisen für das Android-Gradle-Plug-in.
Mindestversionen der Tools für Android API-Level
Es gibt Mindestversionen von Android Studio und AGP, die eine bestimmte API-Ebene unterstützen. Wenn Sie niedrigere Versionen von Android Studio oder AGP verwenden, als für targetSdk
oder compileSdk
Ihres Projekts erforderlich sind, kann dies zu unerwarteten Problemen führen. Wir empfehlen, die neueste Vorschauversion von Android Studio und AGP zu verwenden, um an Projekten zu arbeiten, die auf Vorschauversionen des Android-Betriebssystems ausgerichtet sind. Sie können Vorschauversionen von Android Studio zusammen mit einer stabilen Version installieren.
Die folgenden Mindestversionen von Android Studio und AGP sind:
API-Ebene | Mindestversion von Android Studio | Mindest-AGP-Version |
---|---|---|
Vorschau: VanillaIceCream | Quallen | 1.3.2023 | 8,4 |
34 | Igel | 1.1.2023 | 8.1.1 |
33 | Flamingo | 1.2.2022 | 7,2 |
Änderungen an der Versionsverwaltung (November 2020)
Wir aktualisieren die Versionsnummern für das Android-Gradle-Plug-in (AGP), damit sie besser mit dem zugrunde liegenden Gradle-Build-Tool übereinstimmt.
Hier die wichtigsten Änderungen:
AGP verwendet jetzt eine semantische Versionsverwaltung. Wichtige Änderungen werden auf Hauptversionen ausgerichtet.
Pro Jahr wird eine Hauptversion von AGP veröffentlicht, die der Hauptversion von Gradle entspricht.
Der Release nach AGP 4.2 ist dann Version 7.0 und erfordert ein Upgrade auf Gradle-Version 7.x. Für jeden Hauptrelease von AGP ist ein Upgrade der Hauptversion im zugrunde liegenden Gradle-Tool erforderlich.
APIs werden etwa ein Jahr im Voraus eingestellt. Die Ersatzfunktionalität wird zeitgleich zur Verfügung gestellt. Verworfene APIs werden etwa ein Jahr später im Rahmen des nachfolgenden größeren Updates entfernt.
Kompatibilität
Das Android-Gradle-Plug-in 8.5 unterstützt maximal das API-Level 34. Weitere Informationen zur Kompatibilität:
Mindestversion | Standardversio | Hinweise | |
---|---|---|---|
Logo: Gradle | 8,7 | 8,7 | Weitere Informationen finden Sie unter Gradle aktualisieren. |
SDK-Build-Tools | 34.0.0 | 34.0.0 | Installieren oder konfigurieren Sie SDK-Build-Tools. |
Logo: NDK | – | 26.1.10909125 | Installieren oder konfigurieren Sie eine andere Version des NDK. |
JDK | 17 | 17 | Weitere Informationen finden Sie unter JDK-Version festlegen. |
Patch releases
Im Folgenden finden Sie eine Liste der Patchreleases in Android Studio Koala und des Android-Gradle-Plug-ins 8.5.
Android Studio Koala | 2024.1.1 Patch 1 und AGP 8.5.1 (Juli 2024)
Dieses kleinere Update enthält diese Fehlerkorrekturen.