Phụ lục C, phiên bản tương thích tối thiểu cho API Trình bổ trợ giao diện người dùng trên ô tô

Các nhà sản xuất thiết bị gốc (OEM) dự kiến sẽ chuyển sang phiên bản mới nhất của car-ui-lib-plugin-apis (1.2.0 trở lên) sớm nhất có thể. Tốt nhất là nhà sản xuất thiết bị gốc (OEM) không nên vận chuyển bất kỳ trình bổ trợ nào sử dụng phiên bản cũ.

Lý do cập nhật

Các API Java 8 trở lên được hỗ trợ cho các phiên bản Android trước đó thông qua tính năng hỗ trợ đơn giản hoá API Java 8 trở lên. Các phương thức triển khai API bị thiếu được biên dịch thành ứng dụng và mã byte của APK được viết lại để tham chiếu các phương thức triển khai thay vì thư viện trên nền tảng.

Việc tải các thành phần giao diện người dùng do OEM triển khai từ trình bổ trợ Thư viện giao diện người dùng trên ô tô yêu cầu tham chiếu các phương thức do giao diện car-ui-lib-plugin-apis xác định. Các tệp tham chiếu phương thức này được tạo từ ứng dụng đến trình bổ trợ Thư viện giao diện người dùng trên ô tô trong thời gian chạy với kỳ vọng rằng chữ ký phương thức giống hệt nhau trong quá trình triển khai ứng dụng và trình bổ trợ.

Một số hệ thống xây dựng luôn bật tính năng đơn giản hoá API do các yêu cầu về cấp độ SDK tối thiểu cụ thể. Chữ ký phương thức đã đơn giản hoá cho giao diện car-ui-lib-plugin-apis có thể không khớp với chữ ký trong quá trình triển khai trình bổ trợ OEM chưa được đơn giản hoá, dẫn đến việc trình bổ trợ không tải được.

Do đó, một số ứng dụng GAS được biên dịch bằng hệ thống xây dựng nội bộ của Google không tương thích với trình bổ trợ Thư viện giao diện người dùng trên ô tô. Do đó, chúng tôi đã xoá tất cả các phần phụ thuộc trên các API Java 8 (trở lên) yêu cầu đơn giản hoá. Thay đổi này yêu cầu cập nhật API của các giao diện do car-ui-lib-plugin-apis xác định.

Các bước bắt buộc đối với trình bổ trợ OEM

Hãy làm theo các bước sau để cập nhật API:

  1. Cập nhật cách triển khai trình bổ trợ để sử dụng phiên bản mới nhất của car-ui-lib-plugin-apis. Để tải phiên bản mới nhất (1.2.0 trở lên), hãy xem Kho lưu trữ Maven của Google.

  2. Cập nhật cách triển khai trình bổ trợ để triển khai giao diện PluginFactoryOEMV4. Thay đổi này yêu cầu các bước sau khi một thành phần được triển khai bằng trình bổ trợ OEM. Cập nhật cách triển khai của nhà sản xuất thiết bị gốc (OEM) đối với:

    1. Thanh công cụ để triển khai ToolbarControllerOEMV2.

    2. Mục danh sách nội dung để mở rộng ContentListItemOEMV2.

    3. Xử lý kết quả tìm kiếm IME để mở rộng ImeSearchInterfaceOEMV2.

  3. Cập nhật ứng dụng để sử dụng phiên bản mới nhất của Thư viện giao diện người dùng trên ô tô.

Điều gì sẽ xảy ra nếu bạn không áp dụng bản cập nhật này?

Nếu bạn chưa hoàn tất các bước được cung cấp trên trang này cho một trình bổ trợ OEM, thì các ứng dụng đã đơn giản hoá, chẳng hạn như Dịch vụ ô tô của Google (GAS), sẽ không tải được các hoạt động triển khai của trình bổ trợ Thư viện giao diện người dùng ô tô và không có tuỳ chỉnh nào của OEM được áp dụng thông qua cơ chế trình bổ trợ.

Các tuỳ chỉnh RRO hiện có cho Thư viện giao diện người dùng trên ô tô không chịu ảnh hưởng của vấn đề này và tiếp tục hoạt động như bình thường.