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-alpha04 sürümüne güncellemek için Android Studio Narwhal 4 Feature Drop | 2025.1.4'te 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-alpha04'ün desteklediği maksimum Android API düzeyi, API düzeyi 36'dır.

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

Dahili DSL uygulamaları ve desteği sonlandırılan varyant API'si artık açıkça etkinleştirilmelidir

Android Gradle eklentisi artık tanımlanmış bir API yüzeyine sahip. Desteklenen API'ler com.android.tools.build:gradle-api Maven yapısında tanımlanıyor.

Mevcut ikili eklentiler ve derleme komut dosyalarıyla uyumluluk için, tanımlanan API yüzeyinden önce gelen önceki DSL uygulamaları, AGP 8.13 ve önceki sürümlerde varsayılan olarak kullanıma sunulmaya devam etti. Bu sayede Gradle eklentilerindeki ve derleme komut dosyalarındaki kod, DSL'nin hem dahili uygulama ayrıntılarına hem de 2026'da AGP 10'da kaldırılacak olan, kullanımdan kaldırılmış android.applicationVariants, android.libraryVariants, android.testVariants ve android.unitTestVariants API'lerine erişebilir.

Bu geçişi daha görünür hale getirmek için hem eski varyant API'sine hem de dahili DSL'ye varsayılan olarak Android Gradle eklentisi 9.0.0-alpha04'te erişilemez.

android.newDsl=false içinde gradle.properties değerini ayarlayarak kullanımdan kaldırılan API'yi tekrar kullanmaya başlayabilirsiniz.

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

Yerleşik Kotlin

Android Gradle eklentisi 9, Kotlin'i derlemek için yerleşik destek içerir ve ayrı olarak uygulanan Kotlin eklentisinin yerini alır. Bu sayede AGP ile entegrasyon basitleştirilir, kullanımdan kaldırılan API'lerin kullanımı önlenir ve bazı durumlarda performans artırılır.

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

android.builtInKotlin=false ayarını yaparak yerleşik Kotlin'i devre dışı bırakabilirsiniz. Devre dışı bırakmayı seçtiyseniz ve kotlin Gradle eklentisinin eski bir sürümünü kullanmanız gerekiyorsa sürümü düşürmeyi zorlayabilirsiniz.

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 {
    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.

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

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

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

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

• 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ı.

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

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

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
  }
}

Kaldırılan API'ler

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

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

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.