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

Android Gradle Eklentisi (AGP), Android uygulamaları için desteklenen yapı sistemidir ve pek çok farklı türde kaynağı derlemeyi ve bunları fiziksel bir Android cihazda ya da bir emülatörde çalıştırabileceğiniz bir uygulamaya 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şaretlenecektir. Kullanımdan kaldırılan bu API'ler, bir sonraki kararlı sürümde kullanılamaz hale gelecektir. Aşağıda her bir ana AGP sürümünde yapılacak değişiklikler hakkında bilgi verilmiştir.

AGP API'nin kullanımdan kaldırılması veya kaldırılmasıyla ilgili daha ayrıntılı bir günlük için AGP API güncellemelerini inceleyin.

AGP 9.0 (2024 Ortası)

Yeni Variant API'ler stabildir, eski API'ler kullanımdan kaldırılmıştır

  • 4.1 ve 4.2 sürümlerindeki Varyant API'leri kararlıdır.
  • Bu arayüzlerin tümü gradle-api yapısında yer alır.
  • Eski Variant API'de kullanılan önceki arayüzler ve sınıflar kullanımdan kaldırıldı.

Yeni DSL arayüzleri kararlı durumda, eski arayüzler kullanımdan kaldırıldı

  • 4.1, 4.2 ve 7.0 sürümlerinde oluşturulan DSL arayüzleri artık kararlı durumdadır.
  • Bu arayüzlerin tümü gradle-api yapısında yer almaktadır.
  • DSL'de kullanılan önceki arayüzler ve sınıflar artık kullanımdan kaldırılmıştır.

Gizli dahili AGP sınıflarına hâlâ erişilebilir

Derleme dosyalarının derlenmesi sırasında başka yapılarda bulunan özel AGP dahili sınıflarına yine erişilebilir; ancak her an bozulma sorunlarına neden olabileceğinden bu sınıfların kullanılması önerilmez.

AGP 10.0 (2025)

Eski API'ler kaldırıldı

  • DSL 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.
  • Derleme ve çalışma zamanı için farklı bağımlılık grafikleri sunan Gradle meta verileri kullanılarak, derleme dosyalarının derlenmesi sırasında yalnızca gradle-api yapısı kullanılabilir.

(Kesin olmamakla birlikte) Gizli dahili AGP sınıflarına erişim kaldırıldı

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

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