Android Driver SDK 6.0 Taşıma Kılavuzu

DriverStatusListener arayüzüne taşıma

Sürücü sürüm 5'te, StatusListener arayüzünün DriverStatusListener arayüzü lehine kullanımdan kaldırıldığını duyurmuştuk. Bu yıl, StatusListener arayüzünü resmi olarak sileceğiz. Yeni arayüze geçiş kılavuzu için StatusListener desteğinin sonlandırılması başlıklı makaleyi inceleyin.

Kotlin 2.0'a geçiş

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

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

Sürücü SDK'sı 6.0 ile AGP 7.3 veya sonraki bir sürümü kullanmanızı öneririz.

Tam R8 modu

Sürücü SDK'sı 6 ve önceki sürümler Tam R8 modunu desteklemez. Uygulamanız AGP 8.0 ve sonraki sürümleri hedefliyorsa Tam R8 modunu açıkça devre dışı bırakmanız gerekir.

# settings.gradle
android.enableR8.fullMode=false

Kotlin sürüm uyumluluğu

Kotlin, önceki üç dil sürümüyle geriye dönük uyumluluğu destekler. Yani, Driver SDK 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 Kotlin uyumluluğu 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.

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: