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 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'ın Gradle ve Android Gradle eklentisi (AGP) sürümünüz için minimum ve maksimum sürüm gereksinimleri vardır. Projenizin Kotlin 2.0 için bu şartları karşıladığından emin olun.

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

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

Tam R8 modu

Consumer SDK v3 ve önceki sürümler, tam R8 modunu desteklemez. Uygulamanız AGP 8.0 veya sonraki bir sürümü 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, Consumer SDK ile Kotlin 1.7 veya sonraki bir sürümü kullanıyorsanız tüm uyumluluğu bozan 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 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, uyumsuz değişiklikleri sınırlamaya yardımcı olmak için iki işaret sağlar:

language-version X.Y

Bu işaret, önceki bir Kotlin sürümünün davranışındaki zarar veren değişiklikleri geri alır. Örneğin, Kotlin 1.7 kullanıyorsanız [ - language-version 1.7] belirtebilirsiniz. Bu durumda, yeni uyumluluk bozucu 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 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ümde korumak istediğiniz davranışları seçmenizi öneririz. Kotlin, her sürüm için uyumluluk kılavuzlarında, uyumluluğu bozan değişikliklerin listesini ve orijinal davranışın korunması için ayarlanabilecek işaretleri sağlar: