Versionshinweise für Android-Gradle-Plug-in 8.4

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

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

plugins {
    id 'com.android.application' version '8.4.0' apply false
    id 'com.android.library' version '8.4.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.4.+'. 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.4 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.4

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.4 gesetzt.

...
distributionUrl = https\://services.gradle.org/distributions/gradle-8.4-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.3 unterstützt maximal das API-Level 34. Weitere Informationen zur Kompatibilität:

Im Folgenden sind die neuen Funktionen des Android-Gradle-Plug-ins 8.4 aufgeführt.

Patch releases

Im Folgenden finden Sie eine Liste der Patchreleases in Android Studio Jellyfish und Android-Gradle-Plug-in 8.4.

Android Studio Jellyfish | Patch 2 (2023.3.1) und AGP 8.4.2 (Juni 2024)

Wichtiges Sicherheitsupdate:Durch eine Sicherheitslücke im GitHub-Plug-in, die in Android Studio Iguana 2023.2.1 und höher verfügbar ist, können Zugriffstokens unbefugten Dritten zugänglich gemacht werden.

Lösung: Jetbrains hat das Problem in den IntelliJ-Plattformprodukten behoben und ist jetzt in Android Studio Jellyfish | 2023.3.1 Patch 2 (20.3.1.20) verfügbar.

Wenn Sie bereits einen Android Studio-Build auf dem stable Channel haben, können Sie das Update abrufen. Klicken Sie dazu auf Hilfe > Nach Updates suchen (oder Android Studio > Nach Updates suchen unter macOS). Andernfalls laden Sie den neuesten stabilen Build herunter.

Wenn Sie in der IDE die Funktion für GitHub-Pull-Anfragen aktiv genutzt haben, empfehlen wir Ihnen dringend, alle vom Plug-in verwendeten GitHub-Tokens zu widerrufen. Da das Plug-in die OAuth-Integration oder persönliche Zugriffstokens (Personal Access Tokens, PATs) verwenden kann, prüfen Sie beide und widerrufen Sie gegebenenfalls den Widerruf:

• Wenn Sie den Zugriff für die OAuth-Integration widerrufen möchten, rufen Sie Anwendungen > Autorisierte OAuth-Anwendungen auf und widerrufen Sie den Zugriff für das Token der JetBrains-IDE-Integration.
• Wenn Sie den Zugriff für PATs widerrufen möchten, rufen Sie Persönliche Zugriffstokens auf und löschen Sie das für das GitHub-Plug-in ausgestellte Token. Der Standardname für Tokens lautet GitHub-Integrations-Plug-in für IntelliJ IDEA. Möglicherweise verwenden Sie jedoch einen benutzerdefinierten Namen.

Nachdem Sie den Zugriff für die Tokens widerrufen haben, müssen Sie das Plug-in neu einrichten, damit alle Plug-in-Funktionen, einschließlich Git-Vorgängen, wieder funktionieren.

Wir entschuldigen uns für etwaige Unannehmlichkeiten und empfehlen allen Nutzern, umgehend zu aktualisieren, um ihren Code und ihre Daten zu schützen.

Dieses kleinere Update enthält auch diese Fehlerkorrekturen.

Android Studio Jellyfish | Patch 1 (2023.3.1) und AGP 8.4.1 (Mai 2024)

Dieses kleinere Update enthält diese Fehlerkorrekturen.

Bibliotheksklassen sind verkleinert

Ab Version 8.4 des Android-Gradle-Plug-ins werden bei der Minimierung eines Android-Bibliotheksprojekts verkleinerte Programmklassen für die projektübergreifende Veröffentlichung veröffentlicht. Wenn also eine App von der verkleinerten Version der Unterprojekte der Android-Bibliothek abhängig ist, enthält das APK verkleinerte Android-Bibliotheksklassen. Möglicherweise müssen Sie die Bibliotheksbeibehaltungsregeln anpassen, falls Klassen im APK fehlen.

Wenn Sie ein AAE erstellen und veröffentlichen, werden lokale JAR-Dateien, von denen Ihre Bibliothek abhängig ist, in die AAE einbezogen. Das bedeutet, dass Code Shrinker nicht für sie ausgeführt wird.

Wenn Sie das vorherige Verhalten wiederherstellen möchten, legen Sie android.disableMinifyLocalDependenciesForLibraries in der Datei gradle.properties fest und melden Sie einen Fehler. In zukünftigen Versionen von AGP wird dieses Flag entfernt.