Android Tüketici SDK'sı 3.0 Taşıma Kılavuzu

Kotlin 2.0'a geçiş yapma

Android 3.0 ve sonraki sürümler için Consumer SDK'yı kullanıyorsanız Kotlin 2.0'a yükseltmeniz gerekir. Bu sayfada, yeni Kotlin sürümüne geçişi kolaylaştıracak bilgiler verilmektedir.

Gradle ve AGP uyumluluğu

Kotlin 2.0, Gradle ve Android Gradle eklentisi (AGP) sürümünüz için minimum ve maksimum sürüm koşullarına sahiptir. Projenizin Kotlin 2.0 için bu koşulları karşıladığından emin olun.

Tüketici SDK'sı 3.0 ve sonraki sürümler için minimum AGP sürümü

Tüketici SDK'sı 3.0 için AGP 7.3 veya sonraki bir sürümün kullanılması gerekir.

Tam R8 modu

Tüketici SDK'sı v3 ve önceki sürümler, tam R8 modunu desteklemez. Uygulamanız AGP 8.0 ve sonraki sürümleri hedefliyorsa tam R8 modunu açıkça devre dışı bırakmanız gerekir.

# settings.gradle
android.enableR8.fullMode=false

Kotlin sürüm uyumluluğu

Kotlin, önceki üç dil sürümüyle geriye dönük uyumluluğu destekler. Bu nedenle, Tüketici SDK'sı ile Kotlin 1.7 veya sonraki sürümleri kullanıyorsanız tüm zarar veren değişiklikleri çözmek zorunda kalmadan Kotlin 2.0'a geçebilirsiniz. Ancak Kotlin uyumluluğu yalnızca kararlı dil özelliklerinde geçerlidir. Kotlin dilinde alfa, beta veya deneysel özellikler kullanıyorsanız yükseltme yaparken ek değişiklikler yapmanız gerekebilir.

Kotlin uyumluluk işaretleri

Önceki bölümde belirtildiği gibi, Kotlin, yükseltme sırasında dilin en fazla 3 önceki sürümünü destekler. Kotlin, zarar veren değişiklikleri sınırlamaya yardımcı olacak iki işaret sağlar:

language-version X.Y

Bu işaret, zarar veren değişiklikleri önceki bir Kotlin sürümünün davranışına geri döndürür. Örneğin, Kotlin 1.7 kullanıyorsanız [ - language-version 1.7] değerini belirtebilirsiniz. Böylece yeni zarar veren değişiklikler artık geçerli olmaz:

android {
   kotlinOptions {
       languageVersion = '1.7'
   }
}
api-version X.Y

Bu işaret, bağımlı aşağı akış kodu Kotlin 2.0'ı dahil etmeye hazır olmadan yeni API'lerin kullanılmasını engeller.

android {
   kotlinOptions {
       apiVersion = '1.7'
   }
}

Daha hedefli bir yaklaşım

Kotlin uyumluluk işaretlerini kullanmanın yanı sıra Kotlin sürüm notlarını incelemenizi ve yükseltme yaptığınız sürümden korumak istediğiniz davranışları seçmenizi öneririz. Kotlin, her sürüm için uyumluluk kılavuzlarında, uyumsuzluk yaratan değişikliklerin listesini ve orijinal davranışın korunması için ayarlanabilecek işaretleri sağlar: