נספח ג', מינימום גרסה תואמת עבור Car UI Plugin API

יצרני OEM צפויים לעבור לגרסה החדשה ביותר של car-ui-lib-plugin-apis (1.2.0 ומעלה) בהקדם האפשרי. באופן אידיאלי, יצרני OEM לא צריכים לשלוח שום תוסף שמשתמש בגרסה ישנה יותר.

למה העדכון הזה?

ממשקי API של Java 8+ נתמכים עבור גרסאות קודמות של אנדרואיד באמצעות תמיכה ב-Java 8+ API לניקוי סוכר . הטמעות של ממשקי API חסרים נערכים לאפליקציות וקוד הבייטים של APKs נכתב מחדש כדי להתייחס למימושים במקום לספריות בפלטפורמה.

טעינת יישומי OEM של רכיבי ממשק משתמש מפלאגין Car UI Library דורשת התייחסות לשיטות המוגדרות על ידי ממשקי car-ui-lib-plugin-apis . הפניות לשיטה אלו נעשות מאפליקציות לתוספי Car UI Library בזמן ריצה מתוך ציפייה שחתימות השיטה זהות בהטמעת אפליקציות ותוספים.

חלק ממערכות הבנייה מאפשרות ביטול סוכר ב-API בכל עת בשל דרישות של רמת SDK מינימלית ספציפית. חתימות שיטות מנוקות סוכר עבור ממשקי car-ui-lib-plugin-apis עשויות שלא להתאים לאלו ביישום פלאגין OEM שלא בוצע ביטול סוכר, וכתוצאה מכך תוספים לא מצליחים להיטען.

כתוצאה מכך, חלק מהאפליקציות של GAS שהושלמו עם מערכת הבנייה הפנימית של Google אינן תואמות לפלאגין Car UI Library. לכן, הסרנו את כל התלות בממשקי 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. עדכן את האפליקציה כדי להשתמש בגרסה העדכנית ביותר של ספריית ממשק המשתמש של הרכב.

מה קורה אם העדכון הזה לא יוחל?

אם השלבים המופיעים בדף זה לא הושלמו עבור תוסף OEM, אפליקציות שהופסקו בסוכר, כגון Google Automotive Services (GAS), לא מצליחות לטעון את ההטמעות של הפלאגין Car UI Library ולא מוחלות התאמות אישיות של OEM דרך מנגנון הפלאגין.

התאמות RRO קיימות עבור ספריית ממשק המשתמש של הרכב אינן מושפעות מבעיה זו וממשיכות לפעול כרגיל.