Lampiran C, versi minimum yang kompatibel untuk API Plugin UI Mobil

OEM diharapkan beralih ke versi terbaru car-ui-lib-plugin-apis (1.2.0 atau yang lebih tinggi) sesegera mungkin. Idealnya, OEM tidak boleh mengirimkan plugin apa pun yang menggunakan versi lama.

Mengapa update ini?

APIJava 8+ didukung untuk versi Android sebelumnya melalui dukungan desugaring API Java 8+. Implementasi API yang tidak ada dikompilasi ke dalam aplikasi dan kode byte APK ditulis ulang untuk mereferensikan implementasi, bukan library di platform.

Memuat implementasi OEM komponen UI dari plugin Library UI Mobil memerlukan referensi metode yang ditentukan oleh antarmuka car-ui-lib-plugin-apis. Referensi metode ini dibuat dari aplikasi ke plugin Library UI Mobil saat runtime dengan harapan tanda tangan metode identik dalam implementasi aplikasi dan plugin.

Beberapa sistem build mengaktifkan desugaring API setiap saat karena persyaratan level SDK minimum tertentu. Tanda tangan metode yang di-desugar untuk antarmuka car-ui-lib-plugin-apis mungkin tidak cocok dengan yang ada dalam implementasi plugin OEM yang belum di-desugar, sehingga plugin gagal dimuat.

Akibatnya, beberapa aplikasi GAS yang dikompilasi dengan sistem build Google internal tidak kompatibel dengan plugin Library UI Mobil. Oleh karena itu, kami telah menghapus semua dependensi pada API Java 8 (dan yang lebih tinggi) yang memerlukan desugaring. Perubahan ini memerlukan update pada API antarmuka yang ditentukan oleh car-ui-lib-plugin-apis.

Langkah-langkah yang diperlukan untuk plugin OEM

Ikuti langkah-langkah berikut untuk mengupdate API Anda:

  1. Update implementasi plugin untuk menggunakan car-ui-lib-plugin-apis versi terbaru. Untuk mendapatkan versi terbaru (1.2.0 atau yang lebih tinggi), lihat Repositori Maven Google.

  2. Update implementasi plugin untuk mengimplementasikan antarmuka PluginFactoryOEMV4. Perubahan ini memerlukan langkah-langkah berikut saat komponen diimplementasikan oleh plugin OEM. Update implementasi OEM dari:

    1. Toolbar, untuk mengimplementasikan ToolbarControllerOEMV2.

    2. Item daftar konten, untuk memperluas ContentListItemOEMV2.

    3. Penanganan hasil penelusuran IME, untuk memperluas ImeSearchInterfaceOEMV2.

  3. Update aplikasi untuk menggunakan Library UI Mobil versi terbaru.

Apa yang terjadi jika update ini tidak diterapkan?

Jika langkah-langkah yang diberikan di halaman ini tidak diselesaikan untuk plugin OEM, aplikasi yang di-desugar, seperti Google Automotive Services (GAS), akan gagal memuat implementasi plugin Library UI Mobil dan tidak ada penyesuaian OEM yang diterapkan melalui mekanisme plugin.

Penyesuaian RRO yang ada untuk Library UI Mobil tidak terpengaruh oleh masalah ini dan akan terus berfungsi seperti biasa.