Versionshinweise 8.7 des Android-Gradle-Plug-ins

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. Es 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 die letzten Updates enthalten. Versionshinweise zu früheren Android-Gradle-Plug-in-Versionen finden Sie hier.

Informationen dazu, was in dieser Version des Android Gradle-Plug-ins behoben wurde, finden Sie in den geschlossenen Problemen.

Eine allgemeine Zusammenfassung der bevorstehenden bahnbrechenden Änderungen am 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
• Gradle-Leistungshandbuch

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 eine Version basierend auf den Buildanforderungen Ihres Projekts manuell angeben.

Sie können die Plug-in-Version entweder im Menü File > Project Structure > Project (Datei > Projektstruktur > Projekt) in Android Studio oder in der obersten build.gradle.kts-Datei angeben. Die Plug-in-Version gilt für alle Module, die in diesem Android Studio-Projekt erstellt wurden. Im folgenden Beispiel wird das Plug-in anhand der Datei build.gradle.kts auf Version 8.7.0 festgelegt:

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

plugins {
    id 'com.android.application' version '8.7.0' apply false
    id 'com.android.library' version '8.7.0' apply false
    id 'org.jetbrains.kotlin.android' version '2.0.20' apply false
}

Achtung:Sie sollten keine dynamischen Abhängigkeiten in Versionsnummern wie 'com.android.tools.build:gradle:8.7.+' verwenden. Die Verwendung dieser Funktion kann zu unerwarteten Versionsupdates und Schwierigkeiten bei der Behebung von Versionsunterschieden führen.

Wenn die angegebene Plug-in-Version nicht heruntergeladen wurde, wird sie von Gradle beim nächsten Build des Projekts heruntergeladen oder Sie klicken 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 akzeptieren oder eine Version basierend auf den Buildanforderungen Ihres Projekts manuell angeben.

In der folgenden Tabelle ist aufgeführt, welche Gradle-Version für jede Version des Android-Gradle-Plug-ins erforderlich ist. Für eine optimale Leistung sollten Sie sowohl Gradle als auch das Plug-in in der jeweils neuesten Version verwenden.

Sie können die Gradle-Version entweder über das Menü File > Project Structure > Project in Android Studio angeben oder sie über die Befehlszeile aktualisieren. Am besten verwenden Sie das Befehlszeilentool Gradle Wrapper, mit dem die gradlew-Scripts aktualisiert werden. Im folgenden Beispiel wird die Gradle-Version mit dem Gradle-Wrapper auf 8.7 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.7

In einigen Fällen kann dies jedoch fehlschlagen, z. B. wenn Sie AGP gerade aktualisiert haben und es nicht mehr der aktuellen Gradle-Version entspricht. In diesem Fall müssen Sie die Gradle-Verweisdatei in der Datei gradle/wrapper/gradle-wrapper.properties bearbeiten. Im folgenden Beispiel wird die Gradle-Version in der Datei gradle-wrapper.properties auf 8.7 festgelegt.

...
distributionUrl = https\://services.gradle.org/distributions/gradle-8.7-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 AGP-Version für jede Android Studio-Version 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

Es gibt Mindestversionen von Android Studio und AGP, die eine bestimmte API-Ebene unterstützen. Wenn Sie eine niedrigere Version von Android Studio oder AGP verwenden, als für die targetSdk oder compileSdk Ihres Projekts erforderlich ist, kann das zu unerwarteten Problemen führen. Wir empfehlen, die neueste Vorabversion von Android Studio und AGP zu verwenden, wenn Sie an Projekten arbeiten, die auf Vorabversionen des Android-Betriebssystems ausgerichtet sind. Sie können Vorabversionen von Android Studio neben einer stabilen Version installieren.

Die Mindestversionen von Android Studio und AGP sind:

Änderungen bei der Versionierung (November 2020)

Wir aktualisieren die Versionsnummer des Android Gradle-Plug-ins (AGP), damit sie besser mit dem zugrunde liegenden Gradle-Build-Tool übereinstimmt.

Hier sind die wichtigsten Änderungen:

• Für AGP wird jetzt die semantische Versionierung verwendet und funktionsgefährdende Änderungen werden auf Hauptversionen ausgerichtet.

• Es wird pro Jahr eine Hauptversion von AGP veröffentlicht, die mit dem Hauptrelease von Gradle übereinstimmt.

• Die Version nach AGP 4.2 ist Version 7.0 und erfordert ein Upgrade auf Gradle 7.x. Für jede Hauptversion von AGP ist ein Upgrade der Hauptversion des zugrunde liegenden Gradle-Tools erforderlich.

• APIs werden ungefähr ein Jahr im Voraus eingestellt. Gleichzeitig werden Ersatzfunktionen verfügbar gemacht. Eingestellte APIs werden etwa ein Jahr später beim nächsten größeren Update entfernt.

Kompatibilität

Das Android Gradle-Plug-in 8.6 unterstützt maximal API-Level 34. Weitere Informationen zur Kompatibilität:

Änderung am Lint-Verhalten

Ab dem Android Gradle-Plug-in 8.7.0-alpha08 wird bei der Ausführung von lint mit Gradle eine LintError ausgegeben, wenn die Lint-Analyseaufgabe eine Ausnahme auslöst. Durch diese Änderung wird verhindert, dass seltene Fehler im Build-Cache zwischengespeichert werden.

Leider führt diese Änderung dazu, dass Builds für Projekte mit echten LintError-Instanzen in ihren Lint-Baseline-Dateien nicht mehr funktionieren. Die Fehlermeldung enthält Informationen dazu, welche Lint-Prüfungen das Problem verursachen. In einigen Fällen kann das Problem durch Aktualisieren der entsprechenden Bibliothek abhängigkeit behoben werden. Andernfalls können Sie die fehlerhafte Lint-Prüfung deaktivieren, bis der Bibliotheksautor das Problem behoben hat.

Behobene Probleme

Android Gradle Plugin 8.7.0

Android Gradle Plugin 8.7.1

Android Gradle Plugin 8.7.2

Android Gradle Plugin 8.7.3