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ırmak için yol gösterici 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ı içerir. Projenizin Kotlin 2.0 ile ilgili 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ı 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. Yani, Tüketici SDK'sı ile Kotlin 1.7 veya sonraki bir sürümü zaten kullanıyorsanız tüm önemli 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 özellikler kullanıyorsanız yükseltme işlemi sırasında 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, bozucu değişiklikleri sınırlandırmaya yardımcı olmak için iki işaret sağlar:

dil-sürümü X.Y

Bu işaret, önceki bir Kotlin sürümünün davranışında yapılan önemli değişiklikleri geri alır. Örneğin, Kotlin 1.7 kullanıyorsanız [ - language-version 1.7] değerini belirtebilirsiniz. Bu durumda, yeni ve önemli değişiklikler artık geçerli olmaz:

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

Bu işaret, bağımlı alt akış kodu Kotlin 2.0'ı dahil etmeye hazır olmadan önce 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 önemli değişikliklerin ve orijinal davranışı korumak için ayarlanabilecek işaretçilerin listesini sağlar: