Android Gradle Eklentisi DSL/API taşıma zaman çizelgesi

Proje: /studio/_project.yaml Kitap: /studio/_book.yaml açıklama: Bu sayfada, Android Gradle eklentisinin DSL ve API'sinin planlanan gelişimi açıklanmaktadır.

Android Gradle Eklentisi (AGP), Android uygulamaları için desteklenen derleme sistemidir. Birçok farklı kaynak türünü derleme ve bunları fiziksel bir Android cihazda veya emülatörde çalıştırabileceğiniz bir uygulamada bir araya getirme desteği içerir.

Aşağıdaki bölümde, AGP'nin DSL ve API'sinin planlanan gelişimi açıklanmaktadır. Kararlı sürümlerde yeni API'ler kullanıma sunulduğunda eski API'ler kullanımdan kaldırıldı olarak işaretlenir. Desteği sonlandırılan bu API'ler, sonraki kararlı sürümde kullanılamaz hale gelir. Aşağıda, her büyük AGP sürümünde yapılacak değişiklikler hakkında bilgi verilmektedir.

AGP API desteğinin sonlandırılması veya kaldırılmasıyla ilgili daha ayrıntılı bir günlük için AGP API güncellemeleri başlıklı makaleyi inceleyin.

AGP 9.0 (2025'in ikinci yarısı)

Yeni varyant API'leri kararlıdır, eski API'lerin desteği sonlandırılmıştır

  • 4.1 ve 4.2'de geliştirilmekte olan varyant API'leri kararlı.
  • Bu arayüzlerin tümü gradle-api yapısını içerir.
  • Eski Variant API'de kullanılan önceki arayüzler ve sınıflar artık desteklenmiyor.

Yeni DSL arayüzleri kararlıdır, eski arayüzlerin desteği sonlandırılmıştır

  • 4.1, 4.2 ve 7.0 sürümlerinde geliştirme aşamasında olan DSL arayüzleri artık kararlı.
  • Bu arayüzlerin tümü gradle-api yapısında bulunur.
  • DSL'de kullanılan önceki arayüzler ve sınıflar artık desteklenmiyor.

Hâlâ erişilebilen özel dahili AGP sınıfları

AGP'deki diğer yapı taşlarında bulunan özel dahili sınıflara derleme dosyalarının derlenmesi sırasında yine erişilebilir ancak bu sınıflar herhangi bir zamanda önemli değişikliklere uğrayabileceğinden bunları kullanmak önerilmez.

AGP 10.0 (2026)

Eski API'ler kaldırılıyor

  • DSL ve eski Variant API'de kullanılan önceki tüm arayüzler ve sınıflar silinir.
  • DSL ve varyant API arayüzlerine ve sınıflarına erişmek için ihtiyacınız olan tek yapı gradle-api yapısıdır ve eklentiler geliştirirken kullanılmalıdır.
  • Derleme ve çalışma zamanı için farklı bağımlılık grafikleri sunan Gradle meta verilerini kullanarak, derleme dosyalarının derlenmesi sırasında yalnızca gradle-api yapı kullanılabilir.

(Tahmini) Özel dahili AGP sınıflarına erişim kaldırıldı

gradle yapılarına olan bağımlılık artık tüm dahili sınıfları gizler ve derleme erişimini yalnızca gradle-api yapılarında bulunan arayüzlere ve sınıflara verir. Bu durum hem eklentiyi hem de derleme dosyası derlemeyi etkiler.

Dahili sınıflara erişmek için manuel olarak bağımlılık eklemek mümkün değildir.