Harmonogram migracji DSL/API wtyczki Androida do obsługi Gradle

Wtyczka Androida do Gradle (AGP) to obsługiwany system kompilacji aplikacji na Androida. Umożliwia kompilowanie wielu różnych typów źródeł i łączenie ich w aplikację, którą można uruchomić na fizycznym urządzeniu z Androidem lub w emulatorze.

W sekcji poniżej opisujemy planowany rozwój języka DSL i interfejsu API platformy AGP. Wraz z wprowadzaniem nowych interfejsów API w stabilnych wersjach stare interfejsy API będą oznaczane jako wycofane. Wycofane interfejsy API staną się niedostępne w kolejnej stabilnej wersji. Poniżej znajdziesz informacje o nadchodzących zmianach w każdej głównej wersji AGP.

Szczegółowe informacje o wycofanych lub usuniętych interfejsach AGP API znajdziesz w sekcji Aktualizacje interfejsu AGP API.

AGP 9.0 (styczeń 2026 r.)

Nowe interfejsy API wariantów są stabilne, a stare interfejsy API zostały wycofane

  • Interfejsy API wariantów, które były w fazie testów w wersjach 4.1 i 4.2, są już stabilne.
  • Wszystkie te interfejsy znajdują się w artefakcie gradle-api.
  • Poprzednie interfejsy i klasy używane w starym interfejsie Variant API są obecnie wycofane i wymagają wyraźnej zgody na użycie.

Nowe interfejsy DSL są stabilne, a stare zostały wycofane

  • Interfejsy DSL, które były w fazie testów w wersjach 4.1, 4.2 i 7.0, są teraz stabilne.
  • Wszystkie te interfejsy znajdują się w artefakcie gradle-api.
  • Poprzednie interfejsy i klasy używane w DSL są teraz wycofane i wymagają wyraźnej zgody na użycie.

Prywatne wewnętrzne zajęcia AGP są nadal dostępne

Prywatne klasy wewnętrzne z AGP, znajdujące się w innych artefaktach, są nadal dostępne podczas kompilacji plików i wtyczek, ale nie zaleca się ich używania, ponieważ w każdej chwili mogą ulec zmianom powodującym problemy.

AGP 10.0 (koniec 2026 r.)

Usunięcie starych interfejsów API

  • Wszystkie poprzednie interfejsy i klasy używane w DSL i starym interfejsie Variant API zostaną usunięte.
  • Artefakt gradle-api to jedyny artefakt, którego potrzebujesz, aby uzyskać dostęp do interfejsów i klas DSL i variant API. Należy go używać podczas tworzenia wtyczek.

(Wstępnie) Dostęp do prywatnych wewnętrznych klas AGP zostanie usunięty

Zależność od artefaktu gradle ukrywa teraz wszystkie klasy wewnętrzne i zapewnia dostęp do kompilacji tylko interfejsom i klasom dostępnym w artefakcie gradle-api. Ma to wpływ na kompilację wtyczki.

Nie można ręcznie dodać zależności, aby uzyskać dostęp do klas wewnętrznych.