Android-Gradle-Plug-in

Das Build-System von Android Studio basiert auf Gradle. Das Android Gradle-Plug-in bietet mehrere Funktionen, die speziell für das Erstellen von Android-Apps gedacht sind.

Auf dieser Seite wird erläutert, wie Sie Ihre Gradle-Tools auf dem neuesten Stand halten. Versionshinweise zum Android-Gradle-Plug-in finden Sie auf der Seite mit den Versionshinweisen.

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 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 skills add agp-9-upgrade

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 entweder in Android Studio 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 erstellt werden. Im folgenden Beispiel wird das Plug-in aus der Datei build.gradle.kts auf Version 9.4.0 festgelegt:

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

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

Achtung: Sie sollten keine dynamischen Abhängigkeiten in Versionsnummern wie 'com.android.tools.build:gradle:9.4.+' verwenden. Die Verwendung dieser Funktion kann zu unerwarteten Versionsupdates und Schwierigkeiten 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 Android Studio-Menüleiste auf Datei > Projekt mit Gradle-Dateien synchronisieren 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 jeweilige Version des Android-Gradle-Plug-ins erforderlich ist. Für eine optimale Leistung sollten Sie die jeweils neueste Version von Gradle und dem Plug-in verwenden.

Sie können die Gradle-Version entweder in Android Studio im Menü Datei > Projektstruktur > Projekt angeben oder die Gradle-Version über die Befehlszeile aktualisieren. Am besten verwenden Sie das Befehlszeilentool Gradle Wrapper, mit dem die gradlew-Skripts aktualisiert werden. Im folgenden Beispiel wird die Gradle-Version mit dem Gradle-Wrapper auf 9.6.0 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 9.6.0

In einigen Fällen kann dies jedoch fehlschlagen, z. B. wenn Sie das 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 9.6.0 festgelegt.

...
distributionUrl = https\://services.gradle.org/distributions/gradle-9.6.0-bin.zip
...

Kompatibilität zwischen Android-Gradle-Plug-in und Android Studio

Das Build-System von Android Studio basiert auf Gradle. Das Android-Gradle-Plug-in (AGP) fügt mehrere Funktionen hinzu, die speziell für das Erstellen von Android-Apps gedacht sind. In der folgenden Tabelle ist aufgeführt, welche AGP-Version für die einzelnen Android Studio-Versionen 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 ein bestimmtes API-Level unterstützen. Wenn Sie niedrigere Versionen von Android Studio oder AGP verwenden, als für die targetSdk oder compileSdk Ihres Projekts erforderlich sind, kann dies zu unerwarteten Problemen führen. Wir empfehlen, die neueste Vorabversion von Android Studio und AGP zu verwenden, um an Projekten zu arbeiten, die auf Vorabversionen des Android-Betriebssystems ausgerichtet sind. Sie können Vorabversionen von Android Studio parallel zu einer stabilen Version installieren.

Die Mindestversionen von Android Studio und AGP sind: