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

Kotlin 2.0'a geçiş

Android 3.0 ve sonraki sürümler için Tüketici SDK'sını 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.

Consumer SDK 3.0 ve sonraki sürümler için AGP minimum sürümü

Tüketici SDK'sı 3.0, AGP 7.3 veya sonraki bir sürümün kullanılmasını gerektirir.

Tam R8 modu

Tüketici SDK'sı 3 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 yükseltebilirsiniz. Ancak Kotlin uyumluluğu yalnızca kararlı dil özellikleri için geçerlidir. Kotlin dilinde alfa, beta veya deneysel özellikleri 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 önceki 3 sürümünü destekler. Kotlin, zarar veren değişiklikleri sınırlamaya yardımcı olmak için 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ı alt kod Kotlin 2.0'ı kullanmaya hazır olmadan yeni API'lerin kullanılmasını engeller.

android {
   kotlinOptions {
       apiVersion = '1.7'
   }
}

Daha hedefe yönelik 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 zarar veren değişikliklerin ve orijinal davranışı korumak için ayarlanabilecek işaretlerin listesini sunar: