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 erklärt, wie Sie Ihre Gradle-Tools auf dem neuesten Stand halten. Versionshinweise zum Android-Gradle-Plug-in finden Sie auf der Seite Versionshinweise.

Eine allgemeine Zusammenfassung der anstehenden Breaking Changes 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
• Gradle-Leistungsleitfaden

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

Sie können die Plug-in-Version entweder im Menü File > Project Structure > Project in Android Studio oder in der build.gradle.kts Datei der obersten 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 Datei auf Version 9.1.0 festgelegt:build.gradle.kts

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

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

Achtung: Sie sollten keine dynamischen Abhängigkeiten in Versions nummern verwenden, z. B. 'com.android.tools.build:gradle:9.1.+'. 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, lädt Gradle sie beim nächsten Erstellen des Projekts oder wenn Sie in der Android Studio-Menüleiste auf File > Sync Project with Gradle Files 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 neueste verfügbare Version von Gradle und des Plug-ins verwenden.

Sie können die Gradle-Version entweder im Menü File > Project Structure > Project (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.3.1 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.3.1

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

...
distributionUrl = https\://services.gradle.org/distributions/gradle-9.3.1-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 Versioninstallieren.

Die Mindestversionen von Android Studio und AGP sind wie folgt: