Versionshinweise 8.5 des Android-Gradle-Plug-ins

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:

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
}

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.

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.

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:

Ä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:

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.