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

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

เหตุใดจึงต้องอัปเดตนี้

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

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

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

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

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

ทำตามขั้นตอนเหล่านี้เพื่ออัปเดต API ของคุณ:

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

2. อัปเดตการใช้งานปลั๊กอินเพื่อใช้อินเทอร์เฟซ PluginFactoryOEMV4 การเปลี่ยนแปลงนี้จำเป็นต้องมีขั้นตอนต่อไปนี้เมื่อมีการใช้ส่วนประกอบโดยปลั๊กอิน OEM อัปเดตการใช้งาน OEM ของ:

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

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

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

3. อัปเดตแอปเพื่อใช้ Car UI Library เวอร์ชันล่าสุด

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

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

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