Kotlin sürüm uyumluluğu ve taşıma

Bu sayfada, Navigation SDK'nın Kotlin sürümüyle uyumluluğu hakkında bilgi verilmekte ve daha yeni bir sürüme geçişle ilgili yönergeler sunulmaktadır.

Aşağıdaki tabloda, Kotlin sürümü şartları ve Navigation SDK'nın son sürümleri için önerilen AGP ve Gradle sürümleri özetlenmektedir.

Navigation SDK sürümü Kotlin sürümü (zorunlu) Android Gradle eklentisi (AGP) ve Gradle sürümleri (önerilir)
6.2+ 2.1
  • AGP 8.7.3
  • Gradle 8.10.2
6.0 - 6.2 2,0
  • AGP 8.3.0
  • Gradle 8.4
5.1 - 5.99.1 1.9 JDK-8272564 için geçici çözüm içeren AGP 7.3 veya sonraki sürümlerini kullanmanızı öneririz.
minimum ve maksimum sürüm gereksinimlerini inceleyin.

Kotlin sürümü uyumluluğu

Kotlin 2.1, Kotlin 2.0 ile geriye dönük uyumluluğu destekler. Bu, Navigation SDK ile Kotlin 2.0'ı zaten kullanıyorsanız tüm uyumluluğu bozan değişiklikleri çözmek zorunda kalmadan Kotlin 2.1'e yükseltebileceğiniz anlamına gelir. Ancak bu yalnızca kararlı dil özelliklerinde geçerlidir. Kotlin dilinde alfa, beta veya deneysel özellikler kullanıyorsanız yükseltme yaparken ek değişiklikler yapmanız gerekebilir.

Geçişi kolaylaştırma: Kotlin uyumluluk işaretleri

Kotlin, önemli değişiklikleri sınırlamaya yardımcı olmak için iki işaret sağlar: https://kotlinlang.org/docs/compatibility-modes.html

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 2.0 kullanıyorsanız [ - language-version 2.0] belirtebilirsiniz. Bu durumda, yeni uyumsuz değişiklikler artık geçerli olmaz:

android {
   kotlinOptions {
       languageVersion = '2.0'
   }
}

api-version X.Y

Bu işaret, apiVersion sürümünden daha yeni bir Kotlin sürümündeki API kullanıldığında Gradle derleme hatası verir.

android {
   kotlinOptions {
       apiVersion = '2.0'
   }
}

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:

Gelecekteki Kotlin yükseltmeleri

Kotlin 6 ayda bir yeni bir sürüm (yani dil sürümü) yayınlar ve Google genellikle bundan 1-2 ay sonra en son sürümü ürünlerimizde varsayılan olarak kullanır. Önceki Kotlin sürümlerinde, Navigation SDK müşterilerinin daha yeni bir sürüme yükseltmesini gerektiren zarar veren değişiklikler yer alıyordu. Bu nedenle, en yeni Navigation SDK sürümünü kullanırken 6 ayda bir Kotlin'e yükseltme yapmayı planlamanızı öneririz.