Trang này cung cấp thông tin về khả năng tương thích của phiên bản Kotlin đối với Navigation SDK, cũng như hướng dẫn di chuyển sang phiên bản mới hơn.
Yêu cầu về phiên bản Kotlin của Navigation SDK
Bảng sau đây trình bày các yêu cầu về phiên bản Kotlin và phiên bản AGP cũng như Gradle được đề xuất cho các phiên bản gần đây của Navigation SDK.
| Phiên bản Navigation SDK | Phiên bản Kotlin (bắt buộc) | Phiên bản Trình bổ trợ Android cho Gradle (AGP) và Gradle (được đề xuất) |
|---|---|---|
| 7.3 trở lên | 2.2.10 |
|
| 6.3 – 7.2 | 2.1 |
|
| 6.0 – 6.2 | 2 |
|
| 5.1 – 5.99.1 | 1.9 | Bạn nên sử dụng AGP 7.3 trở lên vì phiên bản này có giải pháp thay thế cho JDK-8272564. |
Khả năng tương thích của phiên bản Kotlin
Kotlin 2.2 hỗ trợ khả năng tương thích ngược với Kotlin 2.1. Điều này có nghĩa là nếu đang sử dụng Kotlin 2.1 với Navigation SDK, thì bạn có thể nâng cấp lên Kotlin 2.2 mà không cần giải quyết tất cả các thay đổi gây lỗi. Tuy nhiên, điều này chỉ áp dụng cho các tính năng ngôn ngữ ổn định. Nếu đang sử dụng các tính năng alpha, beta hoặc thử nghiệm trong ngôn ngữ Kotlin, thì bạn có thể phải thực hiện thêm các thay đổi khi nâng cấp.
Giảm bớt quá trình chuyển đổi: Cờ tương thích của Kotlin
Kotlin cung cấp 2 cờ để giúp hạn chế các thay đổi gây lỗi: https://kotlinlang.org/docs/compatibility-modes.html
language-version X.Y
Cờ này hoàn nguyên các thay đổi gây lỗi về hành vi của phiên bản Kotlin trước đó.
Ví dụ: nếu đang sử dụng Kotlin 2.1, bạn có thể chỉ định [ -
language-version 2.1] và các thay đổi gây lỗi mới sẽ không còn có hiệu lực:
android {
kotlinOptions {
languageVersion = '2.1'
}
}
api-version X.Y
Cờ này sẽ gửi lỗi bản dựng Gradle khi sử dụng một API từ phiên bản Kotlin mới hơn apiVersion.
android {
kotlinOptions {
apiVersion = '2.1'
}
}
Phương pháp nhắm mục tiêu hơn
Ngoài việc sử dụng cờ tương thích của Kotlin, bạn nên xem lại ghi chú phát hành Kotlin và chọn những hành vi mà bạn muốn giữ lại từ phiên bản mà bạn đang nâng cấp. Kotlin cung cấp danh sách các thay đổi gây lỗi và các cờ có thể được đặt để giữ lại hành vi ban đầu trong hướng dẫn tương thích cho từng phiên bản:
Nâng cấp Kotlin trong tương lai
Kotlin phát hành phiên bản mới (tức là bản phát hành ngôn ngữ) 6 tháng một lần và Google thường kết hợp phiên bản mới nhất làm phiên bản mặc định trong các sản phẩm của chúng tôi từ 1 đến 2 tháng sau đó. Các phiên bản Kotlin trước đây có các thay đổi gây lỗi, yêu cầu khách hàng của Navigation SDK phải nâng cấp lên phiên bản mới hơn. Do đó, bạn nên lên kế hoạch nâng cấp Kotlin 6 tháng một lần khi áp dụng phiên bản Navigation SDK mới nhất.