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

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

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 sunuldukça eski API'ler kullanımdan kaldırıldı olarak işaretlenir. Desteği sonlandırılan bu API'ler, bir sonraki kararlı sürümde kullanılamayacak. 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 (Ocak 2026)

Yeni Variant API'ler kararlı sürümde, eski API'ler ise kullanımdan kaldırıldı

  • 4.1 ve 4.2'de geliştirme aşamasında olan Variant API'leri kararlı sürüme geçti.
  • Bu arayüzlerin tümü gradle-api yapısında bulunur.
  • Eski Variant API'de kullanılan önceki arayüzler ve sınıflar artık kullanımdan kaldırıldı ve kullanılabilmesi için açıkça etkinleştirilmesi gerekiyor.

Yeni DSL arayüzleri kararlı, eskileri ise kullanımdan kaldırıldı

  • 4.1, 4.2 ve 7.0 sürümlerinde geliştirme aşamasında olan DSL arayüzleri artık kararlı sürümde.
  • Bu arayüzlerin tümü gradle-api yapısında bulunur.
  • DSL'de kullanılan önceki arayüzler ve sınıflar artık kullanımdan kaldırıldı ve kullanılabilmesi için açıkça etkinleştirilmesi gerekiyor.

Özel dahili AGP sınıflarına erişim devam ediyor

AGP'deki diğer yapıtlar içinde bulunan özel dahili sınıflara, derleme dosyalarının ve eklentilerin derlenmesi sırasında erişilebilir. Ancak bu sınıflar herhangi bir zamanda uyumluluğu bozacak şekilde değişebileceğinden bu sınıfların kullanılması önerilmez.

AGP 10.0 (2026 sonları)

Eski API'ler kaldırıldı

  • DSL'de ve eski Variant API'de kullanılan tüm önceki arayüzler ve sınıflar silinir.
  • gradle-api yapısı, DSL ve varyant API arayüzlerine ve sınıflarına erişmek için ihtiyacınız olan tek yapıdır ve eklentiler geliştirirken kullanılmalıdır.

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

gradle yapay ürününe bağımlılık artık tüm dahili sınıfları gizliyor ve derleme erişimini yalnızca gradle-api yapay ürününde bulunan arayüzler ve sınıflarla sınırlıyor. Bu durum, eklenti derlemesini etkiler.

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