Kompatibilitas dan migrasi versi Kotlin

Halaman ini memberikan informasi tentang kompatibilitas versi Kotlin untuk Navigation SDK, serta panduan untuk bermigrasi ke versi yang lebih baru.

Persyaratan versi Kotlin Navigation SDK

Tabel berikut menguraikan persyaratan versi Kotlin dan versi AGP dan Gradle yang direkomendasikan untuk versi terbaru Navigation SDK.

Versi Navigation SDK	Versi Kotlin (wajib)	Versi Android Gradle Plugin (AGP) dan Gradle (direkomendasikan)
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	Sebaiknya gunakan AGP 7.3+, yang memiliki solusi untuk JDK-8272564.

Catatan: Versi AGP yang direkomendasikan yang tercantum di atas memperhitungkan penggunaan R8/D8, yang disertakan dengan AGP. Jika Anda tidak menggunakan R8/D8, lihat persyaratan Kotlin untuk versi minimum dan maksimum untuk Gradle dan AGP.

Kompatibilitas versi Kotlin

Kotlin 2.1 mendukung kompatibilitas dengan versi sebelumnya untuk Kotlin 2.0. Artinya, jika Anda sudah menggunakan Kotlin 2.0 dengan Navigation SDK, Anda dapat mengupgrade ke Kotlin 2.1 tanpa harus menyelesaikan semua perubahan yang menyebabkan gangguan. Namun, hal ini hanya berlaku untuk fitur bahasa stabil. Jika Anda menggunakan fitur alfa, beta, atau eksperimental dalam bahasa Kotlin, Anda mungkin harus melakukan perubahan tambahan saat mengupgrade.

Memudahkan transisi: Flag kompatibilitas Kotlin

Kotlin menyediakan dua tanda untuk membantu membatasi perubahan yang merusak: https://kotlinlang.org/docs/compatibility-modes.html

language-version X.Y

Flag ini mengembalikan perubahan yang merusak perilaku versi Kotlin sebelumnya. Misalnya, jika Anda menggunakan Kotlin 2.0, Anda dapat menentukan [ - language-version 2.0] dan perubahan yang menyebabkan gangguan baru tidak akan lagi berlaku:

android {
   kotlinOptions {
       languageVersion = '2.0'
   }
}

api-version X.Y

Flag ini akan memunculkan error build Gradle saat API dari Kotlin versi yang lebih baru daripada apiVersion digunakan.

android {
   kotlinOptions {
       apiVersion = '2.0'
   }
}

Pendekatan yang lebih bertarget

Selain menggunakan tanda kompatibilitas Kotlin, sebaiknya tinjau catatan rilis Kotlin dan pilih perilaku yang ingin Anda pertahankan dari versi yang Anda upgrade. Kotlin menyediakan daftar perubahan yang merusak dan tanda yang dapat ditetapkan untuk mempertahankan perilaku asli dalam panduan kompatibilitasnya untuk setiap versi:

• Panduan kompatibilitas 1.9
• Panduan kompatibilitas 2.0
• 2.1 panduan kompatibilitas

Upgrade Kotlin mendatang

Kotlin merilis versi baru (yaitu rilis bahasa) setiap 6 bulan dan Google biasanya menyertakan versi terbaru sebagai default di produk kami 1-2 bulan setelahnya. Versi Kotlin sebelumnya telah menyertakan perubahan yang dapat menyebabkan gangguan yang mengharuskan pelanggan Navigation SDK mengupgrade ke versi yang lebih baru. Oleh karena itu, sebaiknya Anda merencanakan upgrade Kotlin setiap 6 bulan saat mengadopsi versi Navigation SDK terbaru.