Das Build-System von Android Studio basiert auf Gradle und dem Android-Gradle-Plug-in. fügt verschiedene Funktionen hinzu, die speziell für die Entwicklung von Android-Apps vorgesehen sind. Obwohl Das Android-Gradle-Plug-in (AGP) wird in der Regel mit Android können das Plug-in (und der Rest des Gradle-Systems) unabhängig von und separat aktualisiert werden.
Auf dieser Seite wird erläutert, wie Sie Ihre Gradle-Tools und was in den letzten Updates enthalten ist. Versionshinweise für frühere Android-Versionen Versionen des Gradle-Plug-ins, siehe früheren Versionshinweisen.
Welche Fehler in dieser Version des Android-Gradle-Plug-ins behoben wurden, findest du unter geschlossenen Problemen.
Allgemeine Zusammenfassung der anstehenden funktionsgefährdenden Änderungen im Android-Gradle-Plug-in finden Sie im Artikel Roadmap für das Gradle-Plug-in
Weitere Informationen zum Konfigurieren von 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 in der Gradle-Nutzerhandbuch
Android-Gradle-Plug-in aktualisieren
Wenn Sie Android Studio aktualisieren, werden Sie möglicherweise aufgefordert, Aktualisieren Sie das Android-Gradle-Plug-in auf die neueste verfügbare Version. Ich können das Update entweder akzeptieren oder manuell eine Version angeben. die Build-Anforderungen Ihres Projekts.
Sie können die Plug-in-Version in
klicken Sie entweder auf Datei > Projekt
Struktur > Projekt in Android Studio oder
der Datei build.gradle.kts auf oberster Ebene. Die Plug-in-Version gilt für
alle Module, die in diesem Android Studio-Projekt integriert sind. Im folgenden Beispiel wird festgelegt,
vom Plug-in auf Version 8.6.0
build.gradle.kts-Datei:
Kotlin
plugins {
id("com.android.application") version "8.6.0" apply false
id("com.android.library") version "8.6.0" apply false
id("org.jetbrains.kotlin.android") version "2.0.20" apply false
}
Cool
plugins {
id 'com.android.application' version '8.6.0' apply false
id 'com.android.library' version '8.6.0' apply false
id 'org.jetbrains.kotlin.android' version '2.0.20' apply false
}
Achtung:Sie sollten keine dynamischen Abhängigkeiten in Version
Zahlen wie
'com.android.tools.build:gradle:8.6.+'
Die Verwendung dieser Funktion kann zu unerwarteten Versionsupdates und Schwierigkeiten führen
um Versionsunterschiede zu beheben.
Wenn die angegebene Plug-in-Version nicht heruntergeladen wurde, wird sie von Gradle heruntergeladen. Wenn Sie das nächste Mal Ihr Projekt erstellen oder auf File (Datei) > klicken. Projekt mit Gradle-Dateien synchronisieren über die Menüleiste in Android Studio.
Gradle aktualisieren
Wenn Sie Android Studio aktualisieren, werden Sie möglicherweise aufgefordert, auch Aktualisieren Sie Gradle auf die neueste verfügbare Version. Sie können die Version basierend auf dem Build Ihres Projekts aktualisieren oder manuell angeben Anforderungen.
In der folgenden Tabelle ist die jeweils erforderliche Gradle-Version aufgeführt. Version des Android-Gradle-Plug-ins. Um die beste Leistung zu erzielen, 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 über die Schaltfläche File >
Projektstruktur > Projekt in Android Studio,
oder aktualisieren Sie Ihre Gradle-Version über die Befehlszeile.
Am besten verwenden Sie die Methode
Gradle-Wrapper
Befehlszeilentool, das die gradlew-Skripts aktualisiert. Die folgenden
wird die Gradle-Version mithilfe des Gradle-Wrappers auf 8.6 gesetzt.
Sie müssen diesen Befehl zweimal ausführen, um sowohl Gradle als auch den
Gradle Wrapper selbst (weitere Informationen finden Sie unter
Upgrade des Gradle-Wrappers).
gradle wrapper --gradle-version 8.6
In einigen Fällen kann dies jedoch fehlschlagen, z. B. wenn du den AGP gerade aktualisiert hast
und nicht mehr mit der aktuellen Gradle-Version kompatibel. In diesem Fall
müssen Sie die Referenz zur Gradle-Distribution in der
gradle/wrapper/gradle-wrapper.properties-Datei. Die folgenden
im Beispiel die Gradle-Version auf 8.6
gradle-wrapper.properties-Datei.
...
distributionUrl = https\://services.gradle.org/distributions/gradle-8.6-bin.zip
...
Android-Gradle Plug-in und Android Studio-Kompatibilität
Das Build-System von Android Studio basiert auf Gradle und dem Android-Gradle-Plug-in. Das Plug-in (AGP) bietet verschiedene Funktionen, die speziell für die Entwicklung von Android-Apps vorgesehen sind. Die In der folgenden Tabelle ist aufgeführt, welche AGP-Version für die einzelnen Versionen von Android Studio
<ph type="x-smartling-placeholder">| Android Studio-Version | Erforderliche AGP-Version |
|---|---|
| Marienkäfer | 1.2.2024 | 3,2–8,7 |
| Koala – Feature Drop | 2.1.2024 | 3,2–8,6 |
| Koala | 1.1.2024 | 3,2–8,5 |
| Qualle | 1.3.2023 | 3,2–8,4 |
| Leguan | 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 |
|---|---|
| Elektrischer Aal | 1.1.2022 | 3,2–7,4 |
| Delfin | 1.3.2021 | 3,2–7,3 |
| Streifenhörnchen | 1.2.2021 | 3.2–7.2 |
| Hummeln | 1.1.2021 | 3.2–7.1 |
| Polarfuchs | 1.3.2020 | 3.1–7.0 |
Informationen zu den Neuerungen im Android-Gradle-Plug-in findest du in der Versionshinweise zum Android-Gradle-Plug-in
Mindestversionen der Tools für Android API-Level
Es gibt Mindestversionen von Android Studio und AGP, die eine bestimmte API unterstützen
Sie verwenden ältere Versionen von Android Studio oder AGP, als in Ihrem
targetSdk oder compileSdk des Projekts kann zu unerwarteten Problemen führen. Mi.
empfehlen wir, die neueste Vorschauversion von Android Studio und AGP zu verwenden,
Projekte, die auf Vorschauversionen des Android-Betriebssystems ausgerichtet sind. Sie können
Installation
Vorabversionen von Android Studio zusammen mit einer stabilen Version
Die folgenden Mindestversionen von Android Studio und AGP sind:
| API-Ebene | Mindestversion von Android Studio | Mindest-AGP-Version |
|---|---|---|
| Vorschau für VanillaIceCream | Qualle | 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 Versionsnummer für das Android-Gradle-Plug-in (AGP) dem zugrunde liegenden Gradle-Build-Tool sehr ähnlich.
Hier die wichtigsten Änderungen:
AGP verwendet jetzt eine semantische Versionsverwaltung und wichtige Änderungen für Major-Releases.
Jedes Jahr wird eine Hauptversion von AGP veröffentlicht, der Gradle-Hauptversion.
Der Release nach AGP 4.2 ist Version 7.0 und erfordert ein Upgrade. Gradle-Version 7.x. Jede größere Version von AGP erfordert eine größere Versionsupgrade im zugrunde liegenden Gradle-Tool.
APIs werden etwa ein Jahr im Voraus eingestellt, wobei Ersatzfunktion zeitgleich zur Verfügung gestellt werden. Verworfene APIs etwa ein Jahr später während der nachfolgenden großen aktualisieren.
Kompatibilität
Das Android-Gradle-Plug-in 8.6 unterstützt maximal das API-Level 34. Weitere Informationen zur Kompatibilität: