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 ada pembaruan ini?

API Java 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 Car UI Library saat runtime dengan harapan bahwa tanda tangan metode identik dalam implementasi aplikasi dan plugin.

Beberapa sistem build mengaktifkan penghilangan gula 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 menyebabkan plugin gagal dimuat.

Akibatnya, beberapa aplikasi GAS yang dikompilasi dengan sistem build Google internal tidak kompatibel dengan plugin Car UI Library. 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 memperbarui API Anda:

  1. Perbarui penerapan 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. Perbarui implementasi plugin untuk menerapkan antarmuka PluginFactoryOEMV4. Perubahan ini memerlukan langkah-langkah berikut saat komponen diimplementasikan oleh plugin OEM. Perbarui penerapan OEM:

    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 Car UI Library 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), gagal memuat penerapan plugin Car UI Library 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 berfungsi seperti biasa.