Hướng dẫn di chuyển SDK trình điều khiển Android 6.0

Di chuyển sang giao diện DriverStatusListener

Trong Driver phiên bản 5, chúng tôi đã thông báo về việc ngừng sử dụng giao diện StatusListener để chuyển sang dùng DriverStatusListener. Năm nay, chúng tôi sẽ chính thức xoá giao diện StatusListener. Tham khảo thông báo ngừng sử dụng StatusListener để xem hướng dẫn di chuyển sang giao diện mới.

Di chuyển sang Kotlin 2.0

Nếu đang sử dụng Driver SDK 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 giữ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). Đả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 Driver SDK 6.0 trở lên

Bạn nên sử dụng AGP 7.3 trở lên với Driver SDK 6.0.

Chế độ R8 đầy đủ

Driver SDK phiên bản 6 trở xuống không hỗ trợ chế độ R8 đầy đủ. Bạn phải tắt rõ ràng chế độ Full R8 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 đang sử dụng Kotlin 1.7 trở lên với Driver SDK, 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 với Kotlin 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 các thay đổi bổ sung khi nâng cấp.

Cờ tương thích Kotlin

Như đã đề cập trong phần trước, Kotlin hỗ trợ tối đa 3 phiên bản trước của ngôn ngữ 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 một phiên bản Kotlin trước đó. Ví dụ: nếu đang 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-version X.Y

Cờ này ngăn việc sử dụng các API mới 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'
   }
}

Cách tiếp cận có mục tiêu cụ thể hơn

Ngoài việc sử dụng cờ tương thích Kotlin, bạn nên xem kỹ 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 có thể 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 về khả năng tương thích cho từng phiên bản: