אובייקט ממשק ספק

מסמך זה מתאר את העיצוב של אובייקט ממשק הספק (אובייקט VINTF), המאגד מידע רלוונטי על מכשיר והופך את המידע הזה לזמין באמצעות API שניתן לשאילתה .

עיצוב אובייקטים VINTF

אובייקט VINTF אוסף חלק מהמידע הדרוש לו ישירות מהמכשיר. היבטים אחרים, כגון המניפסטים, מתוארים באופן סטטי ב-XML.

איור 1. מניפסטים, מטריצות תאימות ומידע הניתן לאיסוף בזמן ריצה

עיצוב אובייקט VINTF מספק את הדברים הבאים עבור רכיבי התקן ומסגרת:

עבור המכשיר עבור המסגרת
  • מגדיר סכימה עבור הרכיב הסטטי ( קובץ המניפסט של המכשיר ).
  • מוסיף תמיכה בזמן בנייה להגדרת קובץ המניפסט של המכשיר עבור מכשיר נתון.
  • מגדיר את ה- API הניתן לשאילתה בזמן ריצה המאחזר את קובץ המניפסט של המכשיר (יחד עם המידע האחר הנאסף בזמן ריצה) ואורז אותם בתוצאת השאילתה.

אובייקט VINTF חייב להיות אמין ולספק את אותו מידע מלא ללא קשר למועד שבו האובייקט מתבקש (ראה אזהרות ).

מניפסטים ומטריצות

החל מ-Android 8.0, API של זמן ריצה שואל מה יש במכשיר ושולח את המידע הזה לשרת העדכונים ה- OTA (Over-the-Air) ולבעלי עניין אחרים (כגון CTS DeviceInfo ). חלק מהמידע מאוחזר בזמן ריצה וחלק ממנו מוגדר סטטית.

  • מניפסט המכשיר מתאר את המרכיב הסטטי של מה שהמכשיר יכול לספק למסגרת.
  • מטריצת תאימות המסגרת מתארת ​​מה מסגרת האנדרואיד מצפה ממכשיר נתון. המטריצה ​​היא ישות סטטית שהרכבה נקבע באופן ידני במהלך פיתוח המהדורה הבאה של מסגרת האנדרואיד.
  • מניפסט המסגרת מתאר שירותים ברמה גבוהה שהמסגרת יכולה לספק למכשיר.
  • מטריצת תאימות המכשיר מתארת ​​את השירותים שתמונת הספק דורשת מהמסגרת. הרכבו נקבע באופן ידני במהלך פיתוח המכשיר.

יש ליישב את שני זוגות המניפסטים והמטריצות הללו בזמן OTA כדי להבטיח שמכשיר יכול לקבל עדכוני מסגרת התואמים את יכולות המכשיר. באופן כללי, מניפסט מתאר מה מסופק ומטריצת תאימות מתארת ​​את הנדרש.

חלק זה כולל את הפרטים הבאים על מניפסטים ומטריצות:

  • מניפסטים מגדירים את מניפסט המכשיר, מניפסט המסגרת וסכימת קובץ המניפסט.
  • מטריצות תאימות מגדירה את הסכימה עבור מטריצת התאימות.
  • מחזור החיים של FCM מפרט כיצד מוציאים ומסירים רכיבי HIDL HAL וכיצד משתנים קבצי FCM כדי לשקף את הסטטוס של גרסת HAL.
  • DM Development מתאר כיצד ספקים יכולים להגדיר ולהכריז על Target FCM Version במניפסט המכשיר עבור מכשירים חדשים או ליישם גרסאות HAL חדשות ולהגדיל את Target FCM Version בעת שדרוג תמונת הספק עבור מכשירים ישנים.
  • התאמה כללית מגדירה את הכללים להתאמה מוצלחת בין מטריצת תאימות למניפסט.