Zeitplan für die DSL/API-Migration des Android-Gradle-Plug-ins

Projekt: /studio/_project.yaml Buch: /studio/_book.yaml description: Auf dieser Seite wird die geplante Weiterentwicklung der DSL und API des Android Gradle-Plug-ins beschrieben.

Das Android Gradle Plugin (AGP) ist das unterstützte Build-System für Android-Anwendungen. Es unterstützt das Kompilieren vieler verschiedener Quelltypen und das Verknüpfen dieser zu einer Anwendung, die auf einem physischen Android-Gerät oder in einem Emulator ausgeführt werden kann.

Im folgenden Abschnitt wird die geplante Weiterentwicklung der DSL und API der AGP beschrieben. Wenn neue APIs in stabilen Releases eingeführt werden, werden alte APIs als eingestellt gekennzeichnet. Diese eingestellten APIs sind dann in der nächsten stabilen Version nicht mehr verfügbar. Unten finden Sie Informationen zu den bevorstehenden Änderungen in den einzelnen wichtigen AGP-Releases.

Ein detaillierteres Protokoll der Einstellung oder Entfernung von AGP API-Funktionen finden Sie in den AGP API-Aktualisierungen.

AGP 9.0 (zweite Jahreshälfte 2025)

Neue Varianten-APIs sind stabil, alte APIs werden eingestellt

  • Die Variant APIs, die in den Versionen 4.1 und 4.2 in der Entwicklungsphase waren, sind stabil.
  • Alle diese Schnittstellen befinden sich im Artefakt gradle-api.
  • Die bisherigen Schnittstellen und Klassen, die in der alten Variant API verwendet wurden, werden jetzt eingestellt.

Neue DSL-Schnittstellen sind stabil, alte werden eingestellt

  • Die DSL-Schnittstellen, die in den Versionen 4.1, 4.2 und 7.0 in der Entwicklungsphase waren, sind jetzt stabil.
  • Alle diese Schnittstellen befinden sich im Artefakt gradle-api.
  • Die bisherigen Schnittstellen und Klassen, die in der DSL verwendet wurden, sind jetzt veraltet.

Weiterhin Zugriff auf private interne AGP-Kurse

Private interne Klassen aus AGP, die sich in anderen Artefakten befinden, sind während der Kompilierung von Build-Dateien weiterhin zugänglich. Es wird jedoch nicht empfohlen, sie zu verwenden, da sie sich jederzeit ändern können.

AGP 10.0 (2026)

Alte APIs werden entfernt

  • Alle vorherigen Schnittstellen und Klassen, die in der DSL und der alten Variant API verwendet wurden, werden gelöscht.
  • Das gradle-api-Artefakt ist das einzige Artefakt, das Sie zum Zugriff auf DSL- und Varianten-API-Schnittstellen und ‑Klassen benötigen. Es sollte beim Entwickeln von Plug-ins verwendet werden.
  • Wenn Sie Gradle-Metadaten verwenden, die unterschiedliche Abhängigkeitsgraphen für die Kompilierung und Laufzeit bieten, ist während der Kompilierung von Build-Dateien nur das Artefakt gradle-api verfügbar.

(Vorläufig) Zugriff auf private interne AGP-Klassen entfernt

Durch die Abhängigkeit vom gradle-Artefakt werden jetzt alle internen Klassen ausgeblendet und der Kompilierung wird nur Zugriff auf die Schnittstellen und Klassen gewährt, die im gradle-api-Artefakt verfügbar sind. Dies wirkt sich sowohl auf die Kompilierung von Plug-ins als auch von Build-Dateien aus.

Es ist nicht möglich, eine Abhängigkeit manuell hinzuzufügen, um Zugriff auf die internen Klassen zu erhalten.