ภาคผนวก ค. เวอร์ชันที่เข้ากันได้ขั้นต่ำสำหรับ Car UI Plugin API

เราคาดหวังว่า OEM จะเปลี่ยนไปใช้ car-ui-lib-plugin-apis เวอร์ชันล่าสุด (1.2.0 ขึ้นไป) โดยเร็วที่สุด ในอุดมคติแล้ว OEM ไม่ควรจัดส่งปลั๊กอิน ที่ใช้เวอร์ชันเก่า

เหตุผลในการอัปเดตนี้

API Java 8 ขึ้นไป ได้รับการรองรับสำหรับ Android เวอร์ชันก่อนหน้าผ่านการรองรับการยกเลิกการเพิ่มน้ำตาลในไวยากรณ์ของ Java 8 ขึ้นไป การติดตั้งใช้งาน API ที่ขาดหายไปจะได้รับการคอมไพล์เป็นแอป และระบบจะเขียนไบต์โค้ดของ APK ใหม่เพื่ออ้างอิงการติดตั้งใช้งานแทนไลบรารีในแพลตฟอร์ม

การโหลดการติดตั้งใช้งานคอมโพเนนต์ UI ของ OEM จากปลั๊กอินไลบรารี UI ของรถยนต์ ต้องมีการอ้างอิงเมธอดที่กำหนดโดยอินเทอร์เฟซ car-ui-lib-plugin-apis การอ้างอิงเมธอดเหล่านี้มาจากแอปไปยังปลั๊กอิน Car UI Library ที่รันไทม์ โดยคาดว่าลายเซ็นเมธอดจะเหมือนกันในการใช้งานแอปและ ปลั๊กอิน

ระบบบิลด์บางระบบจะเปิดใช้การยกเลิกการเพิ่มน้ำตาลใน API ตลอดเวลาเนื่องจากข้อกำหนดของ ระดับ SDK ขั้นต่ำที่เฉพาะเจาะจง ลายเซ็นของเมธอดที่ไม่ได้ทำการ Desugar สำหรับอินเทอร์เฟซ car-ui-lib-plugin-apis อาจไม่ตรงกับลายเซ็นในปลั๊กอิน OEM ที่ไม่ได้ทำการ Desugar ซึ่งส่งผลให้ปลั๊กอินโหลดไม่สำเร็จ

ด้วยเหตุนี้ แอป GAS บางแอปที่คอมไพล์ด้วยระบบบิลด์ภายในของ Google จึงใช้ร่วมกับปลั๊กอินไลบรารี UI ของรถยนต์ไม่ได้ ดังนั้น เราจึงนำการอ้างอิงทั้งหมดใน API ของ Java 8 (และสูงกว่า) ที่ต้องมีการแยกส่วนออก การเปลี่ยนแปลงนี้ ต้องมีการอัปเดต API ของอินเทอร์เฟซที่กำหนดโดย car-ui-lib-plugin-apis

ขั้นตอนที่จำเป็นสำหรับปลั๊กอิน OEM

ทำตามขั้นตอนต่อไปนี้เพื่ออัปเดต API

1. อัปเดตการติดตั้งใช้งานปลั๊กอินเพื่อใช้ car-ui-lib-plugin-apis เวอร์ชันล่าสุด หากต้องการรับเวอร์ชันล่าสุด (1.2.0 ขึ้นไป) โปรดดูที่เก็บ Maven ของ Google

2. อัปเดตการติดตั้งใช้งานปลั๊กอินเพื่อติดตั้งใช้งานอินเทอร์เฟซ PluginFactoryOEMV4 การเปลี่ยนแปลงนี้ต้องใช้ขั้นตอนต่อไปนี้เมื่อ OEM ปลั๊กอินใช้คอมโพเนนต์ อัปเดตการติดตั้งใช้งาน OEM ของ

   1. แถบเครื่องมือเพื่อใช้ ToolbarControllerOEMV2

   2. รายการเนื้อหาเพื่อขยาย ContentListItemOEMV2

   3. การจัดการผลการค้นหาของ IME เพื่อขยาย ImeSearchInterfaceOEMV2

3. อัปเดตแอปเพื่อใช้ไลบรารี UI ของรถยนต์เวอร์ชันล่าสุด

จะเกิดอะไรขึ้นหากไม่ได้ใช้การอัปเดตนี้

หากไม่ได้ทำตามขั้นตอนที่ระบุในหน้านี้สำหรับปลั๊กอิน OEM แอปที่ผ่านการ Desugar เช่น Google Automotive Services (GAS) จะโหลดการติดตั้งใช้งาน ของปลั๊กอิน Car UI Library ไม่ได้ และจะไม่มีการใช้การปรับแต่ง OEM ผ่าน กลไกปลั๊กอิน

การปรับแต่ง RRO ที่มีอยู่สำหรับไลบรารี UI ของรถจะไม่ได้รับผลกระทบจากปัญหานี้และจะยังคงทำงานตามปกติ