Kotlin 2.0'a geçiş

Android 6.0 ve sonraki sürümler için Navigasyon 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.

Navigasyon SDK'sı 6.0 ve sonraki sürümler için minimum AGP sürümü

AGP 8.3'ü Navigation SDK 6.0 ile 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 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ışı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'ı kullanmaya 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: