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 eklentisi 9.0.0-beta04 sürümüne güncellemek için Android Studio Otter 3 Feature Drop | 2025.2.3 sürümündeki Android Gradle eklentisi Yükseltme Asistanı'nı kullanın.

AGP yükseltme asistanı, projenizi yükseltirken uygun olduğunda mevcut davranışları korumanıza 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-beta04'ün desteklediği maksimum Android API düzeyi, API düzeyi 36'dır.

Android Gradle eklentisi 9.0.0-beta04 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üzlerdeki çalışmalar devam ederken uyumluluğu korumak için yeni herkese açık arayüzleri de uygulayan eski DSL türleri (ör. BaseExtension) kullanılıyordu.

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 işlem, eski ve kullanımdan kaldırılmış 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üncelleyip 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 kullanılabildiğinden yeni ve eski sürümleri 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 geliştirmeleri ve yayınlamaları için yardımcı oluyoruz. 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, yerleşik Kotlin desteği sunar ve bu desteği varsayılan olarak etkinleştirir. Bu nedenle, Kotlin kaynak dosyalarını derlemek için artık derleme dosyalarınızda org.jetbrains.kotlin.android (veya kotlin-android) eklentisini uygulamanız gerekmez. Bu, Kotlin'in AGP ile entegrasyonunu basitleştirir, kullanımdan kaldırılan API'lerin kullanılmasını önler ve bazı durumlarda performansı artırır.

Bu nedenle, projenizi AGP 9.0'a yükselttiğinizde yerleşik Kotlin'e geçmeniz veya bu özelliği devre dışı bırakmanız gerekir.

Ayrıca, Kotlin kaynakları olmayan Gradle alt projeleri için yerleşik Kotlin desteğini seçerek devre dışı bırakabilirsiniz.

Kotlin Gradle eklentisine çalışma zamanı bağımlılığı

Android Gradle eklentisi 9.0, yerleşik Kotlin desteği sağlamak için artık Kotlin Gradle eklentisi (KGP) 2.2.10'a çalışma zamanı bağımlılığına sahiptir. Bu nedenle artık KGP sürümü bildirmeniz gerekmez. 2.2.10'dan eski bir KGP sürümü kullanıyorsanız Gradle, KGP sürümünüzü otomatik olarak 2.2.10'a yükseltir. Benzer şekilde, 2.2.10-2.0.2'den eski bir KSP sürümü kullanıyorsanız AGP, KGP sürümüyle eşleşmesi için KSP sürümünü 2.2.10-2.0.2'ye yükseltir.

Daha yeni bir KGP sürümüne yükseltme

KGP veya KSP'nin daha yüksek bir sürümünü kullanmak için üst düzey derleme dosyanıza aşağıdakileri ekleyin:

buildscript {
    dependencies {
        // For KGP
        classpath("org.jetbrains.kotlin:kotlin-gradle-plugin:KGP_VERSION")

        // For KSP
        classpath("com.google.devtoolsksp:symbol-processing-gradle-plugin:KSP_VERSION")
    }
}

Daha eski bir KGP sürümüne geçme

Yalnızca yerleşik Kotlin'i devre dışı bıraktıysanız KGP sürümünü düşürebilirsiniz. Bunun nedeni, AGP 9.0'da yerleşik Kotlin'in varsayılan olarak etkinleştirilmesi ve yerleşik Kotlin'in KGP 2.2.10 veya sonraki sürümlerini gerektirmesidir.

KGP veya KSP'nin daha eski bir sürümünü kullanmak için bu sürümü üst düzey derleme dosyanızda katı sürüm bildirimiyle beyan edin:

buildscript {
    dependencies {
        // For KGP
        classpath("org.jetbrains.kotlin:kotlin-gradle-plugin") {
            version { strictly("KGP_VERSION") }
        }

        // For KSP
        classpath("com.google.devtoolsksp:symbol-processing-gradle-plugin") {
            version { strictly("KSP_VERSION") }
        }
    }
}

Düşürebileceğiniz minimum KGP sürümünün 2.0.0 olduğunu unutmayın.

Test armatürleri için IDE desteği

AGP 9.0, test armatürleri için tam Android Studio IDE desteği sunar.

Fused Library Plugin

Fused Library Plugin (Önizleme), birden fazla kitaplığı tek bir Android kitaplığı AAR olarak yayınlamanıza olanak tanır. Bu sayede kullanıcılarınız yayınladığınız yapay nesnelere daha kolay güvenebilir.

Başlangıç hakkında bilgi için Fused Library ile birden fazla Android kitaplığını tek bir kitaplık olarak yayınlama başlıklı makaleyi inceleyin.

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 {
  defaultConfig {
    testInstrumentationRunner = "..."
  }
}

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
• Yoğunluğa göre bölünmüş APK desteği
  AGP 9.0, ekran yoğunluğuna göre bölünmüş APK oluşturma desteğini kaldırıyor. İşlev ve ilgili API'ler kaldırıldı. AGP 9.0 veya sonraki sürümleri kullanarak APK'ları ekran yoğunluğuna göre bölmek için uygulama paketlerini kullanın.

Değiştirilen DSL

Android Gradle eklentisi 9.0'da aşağıdaki DSL'yi bozan değişiklikler 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 yalnızca kaynak düzeyinde yapılan bir değişikliğe yol açar. Ancak bu değişiklik, engelleme yöntemlerinin CommonExtension'den ApplicationExtension, LibraryExtension, DynamicFeatureExtension ve TestExtension'e taşınması 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 önceki AGP sürümleriyle ikili uyumludur.

DSL kaldırıldı

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. Yerini DependencySelection aldı. kotlin.android.localDependencySelection olarak kullanıma sunulur.

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

• Deneyseldir ancak asla sabitlenmez 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ı.

• DensitySplit, çünkü özellik artık desteklenmiyor. Yerine App Bundle kullanılacaktır.

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 öğesini genişleten VariantBuilder alt türlerinde daha tutarlı bir şekilde adlandırılan enableUnitTest lehine kaldırıldı.

• 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-beta04

Android Gradle eklentisi 9.0.0-beta03

Android Gradle eklentisi 9.0.0-beta02

Android Gradle eklentisi 9.0.0-beta01

Android Gradle eklentisi 9.0.0-alpha14

Android Gradle eklentisi 9.0.0-alpha13

Android Gradle eklentisi 9.0.0-alpha12

Android Gradle eklentisi 9.0.0-alpha11

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