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

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

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

Navigation SDK sürümü Kotlin sürümü (gerekli) Android Gradle eklentisi (AGP) ve Gradle sürümleri (önerilir)
8.0+ 2.3.0
  • AGP 9.0.1
  • Gradle 9.1.0

Önemli: Navigation SDK 8.0 ve sonraki sürümler için AGP 9.0.1, öneri değil minimum şarttır. SDK, minAndroidGradlePluginVersion=9.0.1 beyan ediyor ve AGP'nin önceki bir sürümü kullanılarak yapılan derlemeler başarısız oluyor.

7.7 - 7.9 2.3.0
  • AGP 8.13.2
  • Gradle 8.13
7.3 - 7.6 2.2.10
  • AGP 8.10.0
  • Gradle 8.11.1
6,3 - 7,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ü olan AGP 7.3 ve sonraki sürümleri kullanmanızı öneririz.

Kotlin sürüm uyumluluğu

Kotlin 2.3, Kotlin 2.2 ile geriye dönük uyumluluğu destekler. Bu nedenle, Gezinme SDK'sı ile Kotlin 2.2'yi kullanıyorsanız tüm zarar veren değişiklikleri çözmek zorunda kalmadan Kotlin 2.3'e 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 yaparken ek değişiklikler yapmanız gerekebilir.

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

Kotlin, zarar veren 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, zarar veren değişiklikleri önceki bir Kotlin sürümünün davranışına geri döndürür. Örneğin, Kotlin 2.2 kullanıyorsanız [ - language-version 2.2] değerini belirtebilirsiniz. Bu durumda, yeni zarar veren değişiklikler artık geçerli olmaz:

android {
   kotlinOptions {
       languageVersion = '2.2'
   }
}

api-version X.Y

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

android {
   kotlinOptions {
       apiVersion = '2.2'
   }
}

Daha hedefli 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 zarar veren değişikliklerin ve orijinal davranışı korumak için ayarlanabilecek işaretlerin listesini 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 en yeni sürümü 1-2 ay sonra ürünlerimize varsayılan olarak ekler. Önceki Kotlin sürümlerinde, Navigation SDK müşterilerinin daha yeni bir sürüme geçmesini gerektiren zarar veren değişiklikler yapılmıştır. Bu nedenle, en son Navigasyon SDK'sı sürümünü kullanırken her 6 ayda bir Kotlin yükseltmesi planlamanızı öneririz.