پیوست C، حداقل نسخه سازگار برای Car UI Plugin API

انتظار می رود OEM ها در اسرع وقت به جدیدترین نسخه car-ui-lib-plugin-apis (1.2.0 یا بالاتر) سوئیچ کنند. در حالت ایده آل، OEM ها نباید هیچ افزونه ای را ارسال کنند که از نسخه قدیمی تر استفاده می کند.

چرا این به روز رسانی؟

Java 8+ APIها برای نسخه های قبلی اندروید از طریق پشتیبانی جاوا 8+ API desugaring پشتیبانی می شوند. پیاده‌سازی‌های APIهای گمشده در برنامه‌ها کامپایل می‌شوند و کد بایت‌های APK برای ارجاع به پیاده‌سازی‌ها به جای کتابخانه‌های روی پلتفرم بازنویسی می‌شوند.

بارگیری پیاده‌سازی‌های OEM مؤلفه‌های UI از پلاگین Car UI Library نیازمند ارجاع به روش‌هایی است که توسط واسط‌های car-ui-lib-plugin-apis تعریف شده‌اند. این ارجاع روش از برنامه‌ها به پلاگین‌های Car UI Library در زمان اجرا با این انتظار انجام می‌شود که امضای روش در اجرای برنامه و افزونه یکسان باشد.

برخی از سیستم‌های ساخت به دلیل الزامات حداقل سطح SDK خاص، شیرین‌سازی API را همیشه فعال می‌کنند. امضاهای روش desugared برای واسط‌های car-ui-lib-plugin-apis ممکن است با موارد موجود در یک پلاگین OEM که قندزدایی نشده است مطابقت نداشته باشد، که منجر به بارگیری پلاگین‌ها نمی‌شود.

در نتیجه، برخی از برنامه‌های GAS که با سیستم ساخت داخلی Google کامپایل شده‌اند، با افزونه Car UI Library ناسازگار هستند. بنابراین، ما تمام وابستگی‌های APIهای جاوا ۸ (و بالاتر) را که نیاز به حذف قند دارند حذف کرده‌ایم. این تغییر نیازمند به‌روزرسانی‌های 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. برای استفاده از آخرین نسخه کتابخانه رابط کاربری Car UI، برنامه را به‌روزرسانی کنید.

اگر این به روز رسانی اعمال نشود چه اتفاقی می افتد؟

اگر مراحل ارائه شده در این صفحه برای یک افزونه OEM تکمیل نشود، برنامه‌های قندزدایی، مانند Google Automotive Services (GAS)، اجرای پلاگین Car UI Library را بارگیری نمی‌کنند و هیچ سفارشی‌سازی OEM از طریق مکانیسم افزونه اعمال نمی‌شود.

سفارشی‌سازی‌های RRO موجود برای کتابخانه UI Car تحت تأثیر این مشکل قرار نمی‌گیرند و طبق معمول به کار خود ادامه می‌دهند.