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

Các OEM dự kiến ​​sẽ chuyển sang phiên bản car-ui-lib-plugin-apis mới nhất (1.2.0 trở lên) càng sớm càng tốt. Tốt nhất, OEM không nên gửi bất kỳ plugin nào sử dụng phiên bản cũ hơn.

Tại sao lại cập nhật này?

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

Việc tải triển khai OEM của các thành phần giao diện người dùng từ plugin Thư viện giao diện người dùng trên ô tô yêu cầu tham chiếu các phương pháp được xác định bởi giao diện car-ui-lib-plugin-apis . Các tham chiếu phương pháp này được tạo từ các ứng dụng đến plugin 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 triển khai ứng dụng và plugin.

Một số hệ thống xây dựng cho phép gỡ lỗi API mọi lúc do các yêu cầu của cấp SDK tối thiểu cụ thể. Chữ ký phương thức đã được gỡ bỏ cho car-ui-lib-plugin-apis có thể không khớp với các chữ ký trong triển khai plugin OEM chưa được gỡ bỏ, điều này dẫn đến việc không tải được các plugin.

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

Các bước bắt buộc đối với plugin OEM

Các bước bên dưới mô tả cách cập nhật API của bạn.

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

  2. Cập nhật triển khai plugin để 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 plugin OEM triển khai. Cập nhật việc triển khai OEM của:

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

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

    3. Chuyển giao 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ì xảy ra nếu bản cập nhật này không được áp dụng?

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

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