Versionshinweise zum Android-Gradle-Plug-in 8.12

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.

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.12.0 festgelegt:

plugins {
    id("com.android.application") version "8.12.0" apply false
    id("com.android.library") version "8.12.0" apply false
    id("org.jetbrains.kotlin.android") version "2.1.20" apply false
}

plugins {
    id 'com.android.application' version '8.12.0' apply false
    id 'com.android.library' version '8.12.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.12.+'. 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.

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.

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:

Ä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.12 unterstützt wird, ist API-Level 36. Weitere Informationen zur Kompatibilität:

Behobene Probleme

Android-Gradle-Plug-in 8.12.0