Android 6.0 ve sonraki sürümler için Navigation 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ırmayla ilgili 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ümler için gereksinimleri içerir. Projenizin Kotlin 2.0'ın bu gereksinimlerini karşıladığından emin olun.
Gezinme SDK'sı 6.0 ve sonraki sürümleri için AGP minimum sürümü
Gezinme SDK'sı 6.0 ile AGP 7.3 ve sonraki sürümleri kullanmanızı öneririz. SDK'yı AGP 8.3 ve Gradle 8.4 ile doğruladık. SDK, R8'in Tam Modu ile uyumludur.
Kotlin sürümü uyumluluğu
Kotlin, önceki üç dil sürümüyle geriye dönük uyumluluğu destekler. Yani Navigation 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 bu durum yalnızca kararlı dil özellikleri için geçerlidir. Kotlin dilinde alfa, beta veya deneysel özellikler kullanıyorsanız yeni sürüme geçerken ek değişiklikler yapmanız gerekebilir.
Geçişi kolaylaştırma: Kotlin uyumluluk işaretleri
Önceki bölümde belirtildiği gibi, Kotlin yeni sürüme geçerken dilin en fazla 3 eski sürümünü destekler. Kotlin, zarar verici değişiklikleri sınırlamaya 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ışına zarar veren değişiklikleri geri alır.
Örneğin, Kotlin 1.7 sürümünü kullanıyorsanız [ -
language-version 1.7]
değerini belirtebilirsiniz. Bu durumda yeni zarar veren değişiklikler artık geçerli olmaz:
android {
kotlinOptions {
languageVersion = '1.7'
}
}
api X.Y sürümü
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ümden korumak istediğiniz davranışları seçmenizi de öneririz. Kotlin, zarar veren değişikliklerin ve her sürümün uyumluluk kılavuzlarında orijinal davranışı koruyacak şekilde ayarlanabilecek işaretlerin bir listesini sunar.