Android-Gradle-Plug-in

Das Android Studio-Build-System basiert auf Gradle. Das Android-Gradle-Plug-in fügt mehrere Funktionen hinzu, die speziell für das Erstellen von Android-Apps entwickelt wurden.

Auf dieser Seite wird beschrieben, 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 grundlegenden Änderungen im Android-Gradle Plug-in finden Sie in der Roadmap für das Android Gradle-Plug-in.

Weitere Informationen zum Konfigurieren von 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-Build-System finden Sie im Gradle-Nutzerhandbuch.

android skills add --skill 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 angeben, die den Build-Anforderungen Ihres Projekts entspricht.

Sie können die Plug-in-Version entweder im Menü Datei > Projektstruktur > Projekt in Android Studio 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 wurden. Im folgenden Beispiel wird das Plug-in in der build.gradle.kts Datei auf Version 9.3.0 festgelegt:

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

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

Achtung: Sie sollten in Versions nummern keine dynamischen Abhängigkeiten verwenden, z. B. 'com.android.tools.build:gradle:9.3.+'. Die Verwendung dieser Funktion kann zu unerwarteten Versionsupdates führen und es erschweren, Versionsunterschiede zu beheben.

Wenn die angegebene Plug-in-Version nicht heruntergeladen wurde, lädt Gradle sie beim nächsten Erstellen Ihres Projekts oder wenn Sie in der Android Studio-Menüleiste auf Datei > Projekt mit Gradle-Dateien synchronisieren klicken herunter.

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

Sie können die Gradle-Version entweder im Menü Datei > Projektstruktur > Projekt in Android Studio angeben oder Ihre 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 9.5.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.5.0

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 den Gradle-Distributionsverweis in der Datei gradle/wrapper/gradle-wrapper.properties bearbeiten. Im folgenden Beispiel wird die Gradle-Version in der gradle-wrapper.properties Datei auf 9.5.0 festgelegt.

...
distributionUrl = https\://services.gradle.org/distributions/gradle-9.5.0-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) fügt mehrere Funktionen hinzu, die speziell für das Erstellen von Android-Apps entwickelt wurden. 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 zum Android-Gradle-Plug-in.

Mindestversionen von Tools für das 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 targetSdk oder compileSdk Ihres Projekts erforderlich sind, kann dies zu unerwarteten Problemen führen. Wir empfehlen, die neueste Vorabversion von Android Studio und AGP für Projekte zu verwenden, 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 wie folgt: