Bermigrasi ke antarmuka DriverStatusListener
Di Driver v5, kami mengumumkan penghentian penggunaan antarmuka StatusListener
karena diganti dengan DriverStatusListener. Tahun ini, kami secara resmi menghapus
antarmuka StatusListener. Lihat penghentian penggunaan
StatusListener
untuk panduan migrasi ke antarmuka baru.
Bermigrasi ke Kotlin 2.0
Jika menggunakan Driver SDK untuk Android 6.0+, Anda harus mengupgrade ke Kotlin 2.0. Halaman ini memberikan panduan untuk memudahkan transisi ke versi Kotlin baru.
Kompatibilitas Gradle dan AGP
Kotlin 2.0 memiliki persyaratan untuk versi minimum dan maksimum untuk versi Gradle dan Plugin Android Gradle (AGP) Anda. Pastikan project Anda memenuhi persyaratan ini untuk Kotlin 2.0.
Versi minimum AGP untuk Driver SDK 6.0+
Sebaiknya gunakan AGP 7.3+ dengan Driver SDK 6.0.
Mode R8 penuh
Driver SDK v6 dan yang lebih lama tidak mendukung mode R8 Lengkap. Anda harus secara eksplisit menonaktifkan mode R8 Lengkap jika aplikasi Anda menargetkan AGP 8.0+.
# settings.gradle
android.enableR8.fullMode=false
Kompatibilitas versi Kotlin
Kotlin mendukung kompatibilitas mundur dengan tiga versi bahasa sebelumnya. Artinya, jika sudah menggunakan Kotlin 1.7+ dengan Driver SDK, Anda harus dapat mengupgrade ke Kotlin 2.0 tanpa harus menyelesaikan semua perubahan yang menyebabkan error. Namun, kompatibilitas Kotlin hanya berlaku untuk fitur bahasa yang stabil. Jika menggunakan fitur alfa, beta, atau eksperimental dalam bahasa Kotlin, Anda mungkin harus melakukan perubahan tambahan saat mengupgrade.
Flag kompatibilitas Kotlin
Seperti yang disebutkan di bagian sebelumnya, Kotlin mendukung hingga 3 versi bahasa sebelumnya saat mengupgrade. Kotlin menyediakan dua flag untuk membantu membatasi perubahan yang merusak:
versi bahasa X.Y
Flag ini mengembalikan perubahan yang menyebabkan error pada perilaku versi Kotlin sebelumnya.
Misalnya, jika menggunakan Kotlin 1.7, Anda dapat menentukan [ -
language-version 1.7] dan perubahan yang menyebabkan gangguan baru tidak akan lagi berlaku:
android {
kotlinOptions {
languageVersion = '1.7'
}
}
api-version X.Y
Flag ini mencegah API baru digunakan sebelum kode downstream dependen siap untuk menggabungkan Kotlin 2.0.
android {
kotlinOptions {
apiVersion = '1.7'
}
}
Pendekatan yang lebih tertarget
Selain menggunakan flag kompatibilitas Kotlin, sebaiknya tinjau catatan rilis Kotlin dan pilih perilaku yang ingin Anda pertahankan dari versi yang Anda upgrade. Kotlin menyediakan daftar perubahan yang menyebabkan gangguan dan flag yang dapat ditetapkan untuk mempertahankan perilaku asli dalam panduan kompatibilitasnya untuk setiap versi: