Android Gradle eklentisi önizlemesinin sürüm notları

Bu sayfada, Android Gradle eklentisinin (AGP) önizleme sürümlerine ait sürüm notları yer almaktadır.

Android Gradle eklentisi 9.0

Android Gradle eklentisi 9.0, AGP'nin yeni bir ana sürümüdür ve API ile davranış değişiklikleri içerir.

Android Gradle eklentisini 9.0.0-alpha10 sürümüne güncellemek için Android Studio Otter | 2025.2.1'deki Android Gradle eklentisi Yükseltme Asistanı'nı kullanın.

AGP yükseltme asistanı, projenizi yükseltirken uygun olduğunda mevcut davranışları korumaya yardımcı olur. Bu sayede, AGP 9.0'daki tüm yeni varsayılanları kullanmaya hazır olmasanız bile projenizi AGP 9.0'ı kullanacak şekilde yükseltebilirsiniz.

Uyumluluk

Android Gradle eklentisi 9.0.0-alpha10'un desteklediği maksimum Android API düzeyi, API düzeyi 36'dır.

Android Gradle eklentisi 9.0.0-alpha10 için Gradle 9.0.0 gerekir.

android DSL sınıfları artık yalnızca yeni herkese açık arayüzleri uyguluyor

Son birkaç yıldır, hangi API'lerin herkese açık olduğunu daha iyi kontrol etmek için DSL ve API'miz için yeni arayüzler kullanıma sunduk. AGP'nin 7.x ve 8.x sürümlerinde, arayüzler üzerinde çalışmalar devam ederken uyumluluğu korumak için yeni herkese açık arayüzleri de uygulayan eski DSL türleri (ör. BaseExtension) kullanılmaya devam edildi.

AGP 9.0 yalnızca yeni DSL arayüzlerimizi kullanır ve uygulamalar tamamen gizlenmiş yeni türlere dönüştürülmüştür. Bu değişiklikler, eski ve desteği sonlandırılan varyant API'sine erişimi de kaldırır.

AGP 9.0'a güncellemek için aşağıdakileri yapmanız gerekebilir:

• Projenizin yerleşik Kotlin ile uyumlu olduğundan emin olun: org.jetbrains.kotlin.android eklentisi, yeni DSL ile uyumlu değildir.

• KMP projelerini KMP için Android Gradle kitaplık eklentisine geçirme: org.jetbrains.kotlin.multiplatform eklentisinin com.android.library ve com.android.application eklentileriyle aynı Gradle alt projesinde kullanılması yeni DSL ile uyumlu değildir.

• Derleme dosyalarınızı güncelleyin: Arayüzlerin değiştirilmesi, DSL'nin mümkün olduğunca benzer kalmasını sağlamayı amaçlasa da bazı küçük değişiklikler olabilir.

• Özel derleme mantığınızı yeni DSL ve API'ye referans verecek şekilde güncelleyin: Dahili DSL'ye yapılan tüm referansları herkese açık DSL arayüzleriyle değiştirin. Çoğu durumda bu, bire bir değiştirme olacaktır. applicationVariants ve benzeri API'lerin tüm kullanımlarını yeni androidComponents API ile değiştirin. androidComponents API'si, eklentilerin daha uzun süre uyumlu kalması için daha kararlı olacak şekilde tasarlandığından bu işlem daha karmaşık olabilir. Örnekler için Gradle Tarifleri'ne göz atın.

• Üçüncü taraf eklentilerini güncelleyin: Bazı üçüncü taraf eklentileri, artık kullanılmayan arayüzlere veya API'lere bağlı olabilir. Bu eklentilerin AGP 9.0 ile uyumlu sürümlerine geçin.

Yeni DSL arayüzlerine geçiş, aşağıdakiler de dahil olmak üzere çeşitli kullanımdan kaldırılmış API'leri kullanan eklentilerin ve Gradle derleme komut dosyalarının çalışmasını engeller:

androidComponents {
    onVariants() { variant ->
        variant.signingConfig
            .enableV1Signing.set(false)
    }
}

androidComponents {
    beforeVariants(
        selector()
            .withBuildType("debug")
            .withFlavor("color", "blue")
    ) { variantBuilder ->
        variantBuilder.enable = false
    }
  }

AGP 9.0'a güncelledikten sonra aşağıdaki hata mesajını görürseniz projeniz hâlâ eski türlerden bazılarına referans veriyor demektir:

java.lang.ClassCastException: class com.android.build.gradle.internal.dsl.ApplicationExtensionImpl$AgpDecorated_Decorated
cannot be cast to class com.android.build.gradle.BaseExtension

Uyumsuz üçüncü taraf eklentileri tarafından engelleniyorsanız DSL için eski uygulamaları ve eski varyant API'sini geri almak üzere devre dışı bırakabilirsiniz. Bu işlem sırasında yeni arayüzler de kullanılabilir ve kendi derleme mantığınızı yeni API'ye güncelleyebilirsiniz. Bu özelliği devre dışı bırakmak için gradle.properties dosyanıza şu satırı ekleyin:

android.newDsl=false

AGP 9.0'a yükseltmeden önce yeni API'lere yükseltmeye de başlayabilirsiniz. Yeni arayüzler birçok AGP sürümünde mevcuttur. Bu nedenle, yeni ve eski arayüzleri birlikte kullanabilirsiniz. AGP API referans belgelerinde, her AGP sürümünün API yüzeyi ve her sınıf, yöntem ve alanın ne zaman eklendiği gösterilir.

9.0 alfa aşamasında, eklenti yazarlarına yeni modlarla tamamen uyumlu eklentiler uyarlamalarına ve yayınlamalarına yardımcı olmak için ulaşıyoruz. Ayrıca, Android Studio'daki AGP Yükseltme Yardımcısı'nı geliştirerek taşıma sürecinde size yol göstereceğiz.

Yeni DSL veya Variant API'de eksik özellikler olduğunu fark ederseniz lütfen en kısa sürede bir sorun kaydı oluşturun.

Yerleşik Kotlin

Android Gradle eklentisi 9.0, Kotlin'i derlemek için yerleşik destek içerir ve ayrı olarak uygulanan Kotlin eklentisinin yerini alır. Bu, AGP ile entegrasyonu basitleştirir, kullanımdan kaldırılan API'lerin kullanılmasını önler ve bazı durumlarda performansı artırır.

Android Gradle eklentisi 9.0, Kotlin Gradle eklentisi 2.2.10'a çalışma zamanı bağımlılığına sahiptir. Bu, yerleşik Kotlin desteği için gereken minimum sürümdür.

AGP 9.0'da yerleşik olarak bulunan Kotlin, test-fixtures için tam Android Studio IDE desteği sunar. Bu özelliği denemek için AGP 9.0.0-alpha07 veya sonraki bir sürümü kullanın.

android.builtInKotlin=false ayarını yaparak yerleşik Kotlin'i devre dışı bırakabilirsiniz.

Yerleşik Kotlin'i devre dışı bıraktıysanız ve Kotlin Gradle eklentisinin eski bir sürümünü kullanmanız gerekiyorsa sürümü zorla düşürebilirsiniz:

buildscript {
    dependencies {
        classpath("org.jetbrains.kotlin:kotlin-gradle-plugin") {
            version { strictly("2.0.0") } // or another version that you want to use
        }
    }
}

Davranış değişiklikleri

Android Gradle eklentisi 9.0'da aşağıdaki yeni davranışlar bulunur:

AGP 9.0, aşağıdaki Gradle özelliklerinin varsayılan değerleriyle ilgili güncellemeler içerir. Bu sayede, yükseltme yaparken AGP 8.13 davranışını koruma seçeneğine sahip olursunuz:

android {
  buildFeatures {
    resValues = true
  }
}

android {
  buildFeatures {
    shaders = true
  }
}

Kaldırılan özellikler

Android Gradle eklentisi 9.0, aşağıdaki işlevleri kaldırır:

• Yerleştirilmiş Wear OS uygulaması desteği
  AGP 9.0, Wear OS uygulamalarının yerleştirilmesiyle ilgili desteği kaldırıyor. Bu özellik artık Play'de desteklenmiyor. Bu kapsamda, wearApp yapılandırmaları ve AndroidSourceSet.wearAppConfigurationName DSL'nin kaldırılması da yer alır. Uygulamanızı Wear OS'te yayınlama hakkında bilgi edinmek için Wear OS'e dağıtma başlıklı makaleyi inceleyin.
• androidDependencies ve sourceSets rapor görevleri

Değiştirilen DSL

Android Gradle eklentisi 9.0'da aşağıdaki DSL değişiklikleri yapıldı:

• CommonExtension parametrelendirmesi kaldırıldı.

  Bu değişiklik, gelecekte kaynak düzeyinde yapılacak değişikliklerin önüne geçmek için kaynak düzeyinde yapılan bir değişikliktir. Ancak bu değişiklik, blok yöntemlerinin CommonExtension yerine ApplicationExtension, LibraryExension, DynamicFeatureExtension ve TestExtension olarak değiştirilmesi gerektiği anlamına da gelir.

  Projenizi AGP 9.0'a yükseltirken bu parametreleri veya blok yöntemlerini kullanan Gradle eklenti kodunu yeniden düzenleyin. Örneğin, aşağıdaki eklenti, tür parametresini kaldıracak ve kaldırılan blok yöntemlerine dayanmayacak şekilde güncellenir:

  AGP 8.13

  val commonExtension: CommonExtension<*, *, *, *, *, *> =
          extensions.getByType(CommonExtension::class)
  commonExtension.apply {
      defaultConfig {
          minSdk {
              version = release(28)
          }
      }
  }
  

  AGP 9.0

  val commonExtension: CommonExtension =
          extensions.getByType(CommonExtension::class)
  commonExtension.apply {
      defaultConfig.apply {
          minSdk {
              version = release(28)
          }
      }
  }
  

  Bir dizi AGP sürümünü hedefleyen eklentilerde, getter'ı doğrudan kullanmak 9.0'dan düşük AGP sürümleriyle ikili uyumludur.

Kaldırılan DSL

Android Gradle eklentisi 9.0'da kaldırılanlar:

• AndroidSourceSet.jni, çünkü işlevsel değildi.

• AndroidSourceSet.wearAppConfigurationName, kaldırılan yerleşik Wear OS uygulama desteğiyle ilgili olarak.

• BuildType.isRenderscriptDebuggable, çünkü işlevsel değildi.

• DependencyVariantSelection. DependencySelection ile değiştirildi. kotlin.android.localDependencySelection olarak kullanıma sunulur.

• Installation.installOptions(String). Bu özellik, Installation.installOptions öğesinin değiştirilebilir özelliğiyle değiştirildi.

• Deneysel olan ancak asla sabitlenmeyen PostProcessing bloğu.

• ProductFlavor.setDimension, dimension özelliğiyle değiştirilir.

• LanguageSplitOptions, yalnızca kullanımdan kaldırılan Google Play Instant için yararlıydı.

Kaldırılan API'ler

Android Gradle eklentisi 9.0'da kaldırılanlar:

• AndroidComponentsExtension.finalizeDSl. Bu işlevin yerini finalizeDsl aldı.

• Component.transformClassesWith. Bu işlevin yerini Instrumentation.transformClassesWith aldı.

• Component.setAsmFramesComputationMode. Bu işlevin yerini Instrumentation.setAsmFramesComputationMode aldı.

• ComponentBuilder.enabled. Bu işlevin yerini ComponentBuilder.enable aldı.

• DependenciesInfoBuilder.includedInApk. Bu işlevin yerine includeInApk işlevi kullanılacak.

• DependenciesInfoBuilder.includedInBundle. Bu işlevin yerine includeInBundle işlevi kullanılacak.

• GeneratesApk.targetSdkVersion. targetSdk ile değiştirildi.

• Variant.minSdkVersion. minSdk ile değiştirildi.

• Variant.maxSdkVersion. maxSdk ile değiştirildi.

• Variant.targetSdkVersion. targetSdk ile değiştirildi.

• Variant.unitTest, com.android.test eklentisi için geçerli olmadığından. unitTest, VariantBuilder alt türlerinde HasUnitTest için kullanılabilir.

• Kitaplıklarda anlamlı olmadıkları için VariantBuilder.targetSdk ve targetSdkPreview. Bunun yerine GeneratesApkBuilder.targetSdk veya GeneratesApkBuilder.targetSdkPreview kullanın.

• VariantBuilder.enableUnitTest, com.android.test eklentisi için geçerli olmadığından. enableUnitTest, VariantBuilder alt türlerinde HasUnitTestBuilder için kullanılabilir.

• VariantBuilder.unitTestEnabled, HasUnitTestBuilder'ü genişleten VariantBuilder alt türlerinde daha tutarlı bir şekilde adlandırılan enableUnitTest lehine kaldırılıyor.

• VariantOutput.enable. enabled ile değiştirildi.

• Kullanımdan kaldırılan ve devre dışı bırakılan FeaturePlugin ve FeatureExtension.

• Yalnızca AGP 4.2 veya daha eski sürümlerde çalışmayı hedeflerken en yeni AGP sürümüne göre derlemeye izin vermek için kalan, desteği sonlandırılmış ve devre dışı bırakılmış BaseExtension.registerTransform API'ler.

Kaldırılan Gradle özellikleri

Aşağıdaki Gradle özellikleri, başlangıçta varsayılan olarak etkinleştirilen özellikleri genel olarak devre dışı bırakmanın yolları olarak eklenmişti.

Bu özellikler, AGP 8.0 veya daha eski sürümlerde varsayılan olarak devre dışı bırakılmıştır. Daha verimli bir derleme için bu özellikleri yalnızca bunları kullanan alt projelerde etkinleştirin.

android {
  buildFeatures {
    aidl = true
  }
}

android {
  buildFeatures {
    renderScript = true
  }
}

Zorunlu kılınan Gradle özellikleri

AGP 9.0, aşağıdaki Gradle özelliklerini ayarlarsanız hata verir.

Android Gradle eklentisi Yükseltme Asistanı, bu özellikleri kullanan projeleri AGP 9.0'a yükseltmez.

Çözülen sorunlar

Android Gradle eklentisi 9.0.0-alpha10

Android Gradle eklentisi 9.0.0-alpha09

Android Gradle eklentisi 9.0.0-alpha08

Android Gradle eklentisi 9.0.0-alpha07

Android Gradle eklentisi 9.0.0-alpha06

Android Gradle eklentisi 9.0.0-alpha05

Android Gradle eklentisi 9.0.0-alpha04

Android Gradle eklentisi 9.0.0-alpha03

Android Gradle eklentisi 9.0.0-alpha02

Android Gradle eklentisi 9.0.0-alpha01