Versionshinweise 8.6 des Android-Gradle-Plug-ins

Das JCenter-Repository ist seit dem 31. März 2021 schreibgeschützt. Weitere Informationen finden Sie unter Update des JCenter-Dienstes.

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:

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-VersionMindestens erforderliche Gradle-Version
8,58,7
8,48,6
8,38,4
8.28.2
8.18.0
8.08.0
7,47,5

Ältere Versionen

Plug-in-VersionErforderliche Gradle-Version
7,37,4
7,27.3.3
7.17,2
77
4.2.0 und höher6.7.1
4.1.0 und höher6.5 oder höher
4.0.0 und höher6.1.1 und höher
3.6.0–3.6.45.6.4 und höher
3.5.0–3.5.45.4.1 und höher
3.4.0–3.4.35.1.1 und höher
3.3.0–3.3.34.10.1 und höher
3.2.0–3.2.14.6 und höher
3.1.0 und höher4.4 und höher
3.0.0 und höher4.1 und höher
2.3.0 und höher3.3 und höher
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 ü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: