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 Navigation SDK terbaru.

Versi Navigation SDK	Versi Kotlin (wajib)	Versi Plugin Android Gradle (AGP) dan Gradle (direkomendasikan)
7.3+	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	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.2 mendukung kompatibilitas mundur dengan Kotlin 2.1. Artinya, jika Anda sudah menggunakan Kotlin 2.1 dengan Navigation SDK, Anda dapat mengupgrade ke Kotlin 2.2 tanpa harus menyelesaikan semua perubahan yang dapat menyebabkan gangguan. Namun, hal ini hanya berlaku untuk fitur bahasa yang stabil. Jika Anda menggunakan fitur alfa, beta, atau eksperimental dalam bahasa Kotlin, Anda mungkin harus melakukan perubahan tambahan saat mengupgrade.

Mempermudah transisi: Flag kompatibilitas Kotlin

Kotlin menyediakan dua flag untuk membantu membatasi perubahan yang dapat menyebabkan gangguan: https://kotlinlang.org/docs/compatibility-modes.html

language-version X.Y

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

android {
   kotlinOptions {
       languageVersion = '2.1'
   }
}

api-version X.Y

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

android {
   kotlinOptions {
       apiVersion = '2.1'
   }
}

Pendekatan yang lebih bertarget

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 dapat menyebabkan gangguan dan flag yang dapat ditetapkan untuk mempertahankan perilaku asli dalam panduan kompatibilitasnya untuk setiap versi:

• Panduan kompatibilitas 2.0
• Panduan kompatibilitas 2.1
• Panduan kompatibilitas 2.2

Upgrade Kotlin mendatang

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