Kotlin 2.0'a geçiş

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ı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.

Gezinme SDK'sı 6.0 ve sonraki sürümleri için AGP minimum sürümü

Navigation SDK 6.0 ile AGP 7.3 veya sonraki bir sürümü 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 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.

Geçişi kolaylaştırma: 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ışına zarar veren 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 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 ö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.