Di chuyển sang Kotlin 2.0

Nếu đang sử dụng SDK điều hướng cho Android 6.0 trở lên, bạn phải nâng cấp lên Kotlin 2.0. Trang này cung cấp hướng dẫn để giúp bạn dễ dàng chuyển đổi sang phiên bản Kotlin mới.

Khả năng tương thích của Gradle và AGP

Kotlin 2.0 có các yêu cầu đối với các phiên bản tối thiểu và tối đa cho phiên bản Gradle và Trình bổ trợ Android cho Gradle (AGP) của bạn. Hãy đảm bảo dự án của bạn đáp ứng các yêu cầu này đối với Kotlin 2.0.

Phiên bản tối thiểu của AGP cho SDK Navigation 6.0 trở lên

Bạn nên sử dụng AGP 7.3 trở lên với Navigation SDK 6.0. Chúng tôi đã xác minh SDK với AGP 8.3 và Gradle 8.4, đồng thời SDK này tương thích với Chế độ đầy đủ của R8.

Khả năng tương thích với phiên bản Kotlin

Kotlin hỗ trợ khả năng tương thích ngược với 3 phiên bản ngôn ngữ trước đó. Điều này có nghĩa là nếu đã sử dụng Kotlin 1.7 trở lên với SDK Navigation, thì bạn có thể nâng cấp lên Kotlin 2.0 mà không phải giải quyết tất cả các thay đổi có thể 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 bằng 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ờ khả năng tương thích trong Kotlin

Như đã lưu ý trong phần trước, Kotlin hỗ trợ tối đa 3 phiên bản ngôn ngữ trước đó khi nâng cấp. Kotlin cung cấp 2 cờ để giúp hạn chế các thay đổi có thể gây lỗi:

ngôn ngữ-phiên bản X.Y

Cờ này sẽ hoàn nguyên các thay đổi có thể gây lỗi về hành vi của một phiên bản Kotlin trước đó. Ví dụ: nếu đang sử dụng Kotlin 1.7, bạn có thể chỉ định [ - language-version 1.7] và các thay đổi có thể gây lỗi mới sẽ không còn có hiệu lực:

android {
   kotlinOptions {
       languageVersion = '1.7'
   }
}

api phiên bản X.Y

Cờ này ngăn việc sử dụng các API mới trước khi mã phụ thuộc ở hạ nguồn sẵn sàng tích hợp Kotlin 2.0.

android {
   kotlinOptions {
       apiVersion = '1.7'
   }
}

Một phương pháp nhắm mục tiêu cụ thể hơn

Ngoài việc sử dụng cờ tương thích với Kotlin, bạn nên xem lại ghi chú phát hành của 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 có thể gây lỗi và các cờ có thể được thiết lập để giữ lại hành vi gốc trong hướng dẫn về khả năng tương thích cho từng phiên bản: