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

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

Mengapa pembaruan ini?

API Java 8+ didukung untuk Android versi 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 bahwa 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 tanda tangan metode 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 versi terbaru car-ui-lib-plugin-apis. Untuk mendapatkan versi terbaru (1.2.0 atau yang lebih tinggi), lihat Repositori Maven Google.

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

    1. Toolbar, untuk menerapkan 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 Layanan Otomotif Google (GAS), 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 terus berperforma seperti biasa.