Di chuyển sang Kotlin 2.0
Nếu đang sử dụng SDK dành cho người tiêu dùng cho Android 3.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 về 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). Hãy đảm bảo rằng 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 AGP tối thiểu cho SDK dành cho người tiêu dùng 3.0 trở lên
SDK dành cho người tiêu dùng 3.0 yêu cầu sử dụng AGP 7.3 trở lên.
Chế độ R8 đầy đủ
SDK dành cho người tiêu dùng phiên bản 3 trở xuống không hỗ trợ chế độ R8 đầy đủ. Bạn phải tắt rõ ràng chế độ R8 đầy đủ nếu ứng dụng của bạn nhắm đến AGP 8.0 trở lên.
# settings.gradle
android.enableR8.fullMode=false
Khả năng tương thích của 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 dành cho người tiêu dùng, bạn có thể nâng cấp lên Kotlin 2.0 mà không cần giải quyết tất cả các thay đổi gây lỗi. Tuy nhiên, khả năng tương thích của Kotlin chỉ áp dụng cho các tính năng ngôn ngữ ổn định features. 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.
Cờ tương thích của 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 gây lỗi:
language-version X.Y
Cờ này sẽ 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 1.7, bạn có thể chỉ định [ -
language-version 1.7] và các thay đổi gây lỗi mới sẽ không còn có hiệu lực:
android {
kotlinOptions {
languageVersion = '1.7'
}
}
api-version X.Y
Cờ này ngăn không cho các API mới được sử dụng trước khi mã hạ nguồn phụ thuộc sẵn sàng kết hợp Kotlin 2.0.
android {
kotlinOptions {
apiVersion = '1.7'
}
}
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 của Kotlin, bạn nên xem ghi chú phát hành Kotlin và chọn các 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: