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 verschiedene Funktionen, die speziell zum Erstellen von Android-Apps entwickelt wurden. Obwohl das Android-Gradle-Plug-in (AGP) in der Regel mit Android Studio aktualisiert wird, können das Plug-in (und der Rest des Gradle-Systems) unabhängig von Android Studio ausgeführt und separat aktualisiert werden.

Auf dieser Seite wird erläutert, wie Sie Ihre Gradle-Tools auf dem neuesten Stand halten und die neuesten Updates veröffentlichen. Versionshinweise für frühere Versionen des Gradle-Plug-ins für Android finden Sie unter Frühere Versionshinweise.

Informationen zu den Fehlerkorrekturen in dieser Version des Android-Gradle-Plug-ins finden Sie unter Geschlossene Probleme.

Eine allgemeine Zusammenfassung der bevorstehenden 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 für das 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 akzeptieren oder manuell eine Version basierend auf den Build-Anforderungen Ihres Projekts angeben.

Sie können die Plug-in-Version in Android Studio über das Menü Datei > Projektstruktur > Projekt oder in der übergeordneten Datei build.gradle.kts angeben. Die Plug-in-Version gilt für alle Module, die in diesem Android Studio-Projekt erstellt sind. Im folgenden Beispiel wird das Plug-in von 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 Problemen beim Beheben von Versionsunterschieden führen.

Wenn die angegebene Plug-in-Version noch nicht heruntergeladen wurde, wird sie von Gradle heruntergeladen, wenn Sie das nächste Mal Ihr Projekt erstellen oder 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 basierend auf den Build-Anforderungen Ihres Projekts angeben.

In der folgenden Tabelle ist aufgeführt, welche Gradle-Version 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.

Du kannst die Gradle-Version in Android Studio im Menü Datei > Projektstruktur > Projekt angeben oder deine Gradle-Version über die Befehlszeile aktualisieren. In diesem Fall ist es am besten, das Befehlszeilentool Gradle Wrapper zu verwenden, mit dem die gradlew-Skripts aktualisiert werden. Im folgenden Beispiel wird die Gradle-Version mit dem Gradle Wrapper auf 8.4 gesetzt. Hinweis: Du musst diesen Befehl zweimal ausführen, um sowohl Gradle als auch den Gradle-Wrapper selbst zu aktualisieren. Weitere Informationen findest du unter Gradle-Wrapper aktualisieren.

gradle wrapper --gradle-version 8.4

Dies 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 die Gradle-Distributionsreferenz 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 festgelegt.

...
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. Das Android Gradle-Plug-in (AGP) bietet verschiedene Funktionen, die speziell für das Erstellen von Android-Apps entwickelt wurden. In der folgenden Tabelle ist aufgeführt, welche AGP-Version für die jeweilige 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

Es gibt Mindestversionen von Android Studio und AGP, die eine bestimmte API-Ebene unterstützen. Die Verwendung niedrigerer Versionen von Android Studio oder AGP als für targetSdk oder compileSdk Ihres Projekts erforderlich, kann zu unerwarteten Problemen führen. Wir empfehlen, für Projekte, die auf Vorschauversionen des Android-Betriebssystems ausgerichtet sind, die neueste Vorschauversion von Android Studio und AGP zu verwenden. Sie können Vorschauversionen von Android Studio zusammen mit einer stabilen Version installieren.

Für Android Studio und AGP gelten folgende Mindestversionen:

Versionsänderungen (November 2020)

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

Dies sind die wichtigsten Änderungen:

• AGP verwendet jetzt eine semantische Versionsverwaltung und es werden funktionsgefährdende Änderungen für Hauptversionen vorgenommen.

• Pro Jahr wird eine Hauptversion von AGP veröffentlicht, die auf die Gradle-Hauptversion abgestimmt ist.

• Der Release nach AGP 4.2 wird Version 7.0 und erfordert ein Upgrade auf Gradle Version 7.x. Für jeden AGP-Hauptrelease ist ein Upgrade der Hauptversion im zugrunde liegenden Gradle-Tool erforderlich.

• APIs werden etwa ein Jahr im Voraus eingestellt. Ersatzfunktionen sind gleichzeitig verfügbar. Verworfene APIs werden etwa ein Jahr später bei der nachfolgenden großen Aktualisierung entfernt.

Kompatibilität

Das maximale API-Level, das das Android-Gradle-Plug-in 8.3 unterstützt, ist API-Level 34. Weitere Informationen zur Kompatibilität:

Die folgenden neuen Funktionen werden im Android-Gradle-Plug-in 8.4 eingeführt.

Bibliotheksklassen werden verkleinert

Wenn ein Android-Bibliotheksprojekt minimiert wird, werden ab Android Gradle-Plug-in 8.4 verkleinerte Programmklassen für die projektübergreifende Veröffentlichung veröffentlicht. Wenn eine App also von der verkleinerten Version der Unterprojekte der Android-Bibliothek abhängt, enthält das APK auch verkleinerte Android-Bibliotheksklassen. Möglicherweise müssen Sie die Aufbewahrungsregeln für Bibliotheken anpassen, falls Klassen im APK fehlen.

Falls Sie ein AAE erstellen und veröffentlichen, werden lokale JAR-Dateien, von denen Ihre Bibliothek abhängt, nicht im AAE enthalten. Das bedeutet, dass Code Srinker auf ihnen nicht ausgeführt wird.

Wenn Sie zum vorherigen Verhalten zurückkehren möchten, legen Sie in der Datei gradle.properties android.disableMinifyLocalDependenciesForLibraries fest und melden Sie einen Programmfehler. In zukünftigen AGP-Versionen wird dieses Flag entfernt.