נספח ג', הגרסה המינימלית התואמת ל-Car UI Plugin API

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

למה אנחנו מבצעים את העדכון הזה?

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

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

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

כתוצאה מכך, חלק מאפליקציות GAS שנערכו באמצעות מערכת ה-Build הפנימית של Google לא תואמות לתוסף Car UI Library. לכן הסרנו את כל התלות בממשקי Java 8 (ומעלה) API שדורשים desugaring. השינוי הזה מחייב עדכונים ב-API של הממשקים שמוגדרים על ידי car-ui-lib-plugin-apis.

הפעולות הנדרשות לפלאגינים של OEM

כדי לעדכן את ה-API:

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

  2. מעדכנים את ההטמעה של הפלאגין כדי להטמיע את הממשק PluginFactoryOEMV4. כדי לבצע את השינוי הזה, צריך לבצע את השלבים הבאים כשמיישמים רכיב באמצעות התוסף של יצרן הציוד המקורי. עדכון ההטמעה של יצרן הציוד המקורי (OEM) של:

    1. סרגל הכלים, כדי להטמיע את ToolbarControllerOEMV2.

    2. פריטים ברשימת התוכן, כדי להרחיב את ContentListItemOEMV2.

    3. טיפול בתוצאות חיפוש של IME, כדי להרחיב את ImeSearchInterfaceOEMV2.

  3. מעדכנים את האפליקציה כדי להשתמש בגרסה האחרונה של ספריית ממשק המשתמש שברכב.

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

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

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