Android Gradle Eklentisi DSL/API taşıma zaman çizelgesi
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
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
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.
Bu sayfadaki içerik ve kod örnekleri, İçerik Lisansı sayfasında açıklanan lisanslara tabidir. Java ve OpenJDK, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-07-27 UTC.
[[["Anlaması kolay","easyToUnderstand","thumb-up"],["Sorunumu çözdü","solvedMyProblem","thumb-up"],["Diğer","otherUp","thumb-up"]],[["İhtiyacım olan bilgiler yok","missingTheInformationINeed","thumb-down"],["Çok karmaşık / çok fazla adım var","tooComplicatedTooManySteps","thumb-down"],["Güncel değil","outOfDate","thumb-down"],["Çeviri sorunu","translationIssue","thumb-down"],["Örnek veya kod sorunu","samplesCodeIssue","thumb-down"],["Diğer","otherDown","thumb-down"]],["Son güncelleme tarihi: 2025-07-27 UTC."],[],[],null,["# Android Gradle Plugin DSL/API migration timeline\n\nThe Android Gradle Plugin (AGP) is the supported build system for Android\napplications and includes support for compiling many different types of sources\nand linking them together into an application that you can run on a physical\nAndroid device or an emulator.\n\nThe following section describes the planned evolution of the AGP's DSL and API.\nAs new APIs are introduced in stable releases, old APIs will be marked as\ndeprecated. Those deprecated APIs will then become unavailable in the next\nstable release. Below you will find information about upcoming changes in each\nmajor AGP release.\n\nFor a more detailed log of AGP API deprecations or removals, see the [AGP API\nupdates](/studio/releases/gradle-plugin-api-updates).\n| **Note:** The timeframes mentioned below are estimates and are subject to change.\n\nAGP 9.0 (Second half of 2025)\n-----------------------------\n\n**New Variant APIs are stable, old APIs are deprecated**\n\n- The [Variant APIs](https://medium.com/androiddevelopers/new-apis-in-the-android-gradle-plugin-f5325742e614) that were incubating in 4.1 and 4.2 are stable.\n- All of these interfaces are located in the [`gradle-api`](https://maven.google.com/web/index.html#com.android.tools.build:gradle-api) artifact.\n- The previous interfaces and classes used in the old Variant API are now deprecated.\n\n**New DSL interfaces are stable, old ones are deprecated**\n\n- The [DSL interfaces](https://medium.com/androiddevelopers/new-apis-in-the-android-gradle-plugin-f5325742e614) that were incubating in 4.1, 4.2 and 7.0 are now stable.\n- All of these interfaces are located in the `gradle-api` artifact.\n- The previous interfaces and classes used in the DSL are now deprecated.\n\n**Private internal AGP classes still accessible**\n\nPrivate internal classes from AGP, located in other artifacts, are still\naccessible during compilation of build files, but it is **not** recommended\nto use them as they may change in breaking ways at any time.\n\nAGP 10.0 (2026)\n---------------\n\n**Old APIs are removed**\n\n- All previous interfaces and classes used in the DSL and the old Variant API are **deleted**.\n- The `gradle-api` artifact is the only artifact you need to access DSL and variant API interfaces and classes, and should be used when developing plugins.\n- Using Gradle metadata, which offers different dependency graphs for compile and runtime, only `gradle-api` artifact is available during compilation of build files.\n\n**(Tentative) Access to private internal AGP classes is removed**\n\nDependency on the\n[`gradle`](https://maven.google.com/web/index.html#com.android.tools.build:gradle)\nartifact now hides all internal classes and gives compilation access only to the\ninterfaces and classes available in the `gradle-api` artifact. This impacts both\nplugin and build file compilation.\n\nIt isn't possible to manually add a dependency to get access to the internal\nclasses.\n| **Important:** We would like your feedback on the removal of internal AGP classes. Please let us know about your use case, including specific examples of what you need access to, by submitting your feedback on this [tracking issue](https://issuetracker.google.com/219002669)."]]
