Das Android Gradle-Plug-in (AGP) ist das unterstützte Build-System für Android-Anwendungen. Es unterstützt das Kompilieren vieler verschiedener Quelltypen und das Verknüpfen dieser Quelltypen zu einer Anwendung, die Sie auf einem physischen Android-Gerät oder einem Emulator ausführen können.
Im folgenden Abschnitt wird die geplante Entwicklung der DSL und API des AGP beschrieben. Wenn in stabilen Releases neue APIs eingeführt werden, werden alte APIs als eingestellt markiert. 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 Hauptversionen von AGP.
Ein detaillierteres Protokoll der AGP-API-Verwerfungen oder ‑Entfernungen finden Sie unter AGP-API-Updates.
AGP 9.0 (Januar 2026)
Neue Variant-APIs sind stabil, alte APIs werden eingestellt
- Die Variant APIs, die sich in den Versionen 4.1 und 4.2 in der Inkubationsphase befanden, sind jetzt stabil.
- Alle diese Schnittstellen befinden sich im Artefakt
gradle-api. - Die bisherigen Schnittstellen und Klassen, die in der alten Variant API verwendet wurden, sind jetzt veraltet und erfordern eine explizite Einwilligung für die Verwendung.
Neue DSL-Schnittstellen sind stabil, alte sind veraltet
- Die DSL-Schnittstellen, die sich in den Versionen 4.1, 4.2 und 7.0 in der Inkubationsphase befanden, 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 und erfordern eine explizite Einwilligung für die Verwendung.
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 und ‑Plug-ins weiterhin zugänglich. Es wird jedoch nicht empfohlen, sie zu verwenden, da sie sich jederzeit auf inkompatible Weise ändern können.
AGP 10.0 (Ende 2026)
Alte APIs werden entfernt
- Alle bisherigen Schnittstellen und Klassen, die im DSL und in der alten Variant API verwendet wurden, werden gelöscht.
- Das
gradle-api-Artefakt ist das einzige Artefakt, das Sie für den Zugriff auf DSL- und Variant-API-Schnittstellen und -Klassen benötigen. Es sollte bei der Entwicklung von Plug-ins verwendet werden.
(Vorläufig) Zugriff auf private interne AGP-Klassen wird entfernt
Durch die Abhängigkeit vom gradle-Artefakt werden jetzt alle internen Klassen ausgeblendet und der Kompilierungszugriff ist nur auf die Schnittstellen und Klassen beschränkt, die im gradle-api-Artefakt verfügbar sind. Dies wirkt sich auf die Plugin-Kompilierung aus.
Es ist nicht möglich, eine Abhängigkeit manuell hinzuzufügen, um Zugriff auf die internen Klassen zu erhalten.