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

จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ

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

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

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

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

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

ด้วยเหตุนี้ แอป GAS บางแอปที่คอมไพล์ด้วยระบบบิลด์ภายในของ Google จึงใช้ร่วมกับปลั๊กอินไลบรารี UI ของรถไม่ได้ เราจึงนําการพึ่งพา API ของ Java 8 (และเวอร์ชันที่ใหม่กว่า) ทั้งหมดที่จําเป็นต้องมีการถอด Sugar ออกออกแล้ว การเปลี่ยนแปลงนี้จำเป็นต้องมีการอัปเดต 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 แอปที่ผ่านการกรอง Sugar ออกแล้ว เช่น Google Automotive Services (GAS) จะโหลดการติดตั้งใช้งานปลั๊กอิน Car UI Library ไม่ได้ และจะไม่มีการใช้การปรับแต่ง OEM ผ่านกลไกปลั๊กอิน

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