เอกสารนี้อธิบายการออกแบบ ออบเจ็กต์อินเทอร์เฟซผู้ขาย (ออบเจ็กต์ VINTF) ซึ่งรวบรวมข้อมูลที่เกี่ยวข้องเกี่ยวกับอุปกรณ์และทำให้ข้อมูลนั้นพร้อมใช้งานผ่าน API ที่สามารถสืบค้นได้
การออกแบบวัตถุ VINTF
วัตถุ VINTF รวบรวมข้อมูลบางส่วนที่ต้องการโดยตรงจากอุปกรณ์ ลักษณะอื่นๆ เช่น รายการ ได้รับการอธิบายแบบคงที่ในรูปแบบ XML
การออกแบบอ็อบเจ็กต์ VINTF ให้สิ่งต่อไปนี้สำหรับอุปกรณ์และส่วนประกอบของเฟรมเวิร์ก:
สำหรับอุปกรณ์ | สำหรับกรอบการทำงาน |
---|---|
|
|
อ็อบเจ็กต์ VINTF จะต้องเชื่อถือได้และให้ข้อมูลที่ครบถ้วนเหมือนกัน ไม่ว่าอ็อบเจ็กต์จะถูกร้องขอเมื่อใด (ดู Caveats )
รายการและเมทริกซ์
สำหรับ Android 8.0 นั้น runtime API จะค้นหาสิ่งที่อยู่ในอุปกรณ์และส่งข้อมูลนั้นไปยังเซิร์ฟเวอร์อัปเดตแบบ Over-the-Air (OTA) และผู้มีส่วนได้เสียอื่น ๆ (เช่น CTS DeviceInfo
) ข้อมูลบางอย่างถูกดึงออกมาขณะรันไทม์ และบางส่วนถูกกำหนดแบบคงที่
- รายการอุปกรณ์ จะอธิบายองค์ประกอบแบบคงที่ของสิ่งที่อุปกรณ์สามารถมอบให้กับเฟรมเวิร์กได้
- เมทริกซ์ความเข้ากันได้ของเฟรมเวิร์ก จะอธิบายสิ่งที่เฟรมเวิร์ก Android คาดหวังจากอุปกรณ์ที่กำหนด เมทริกซ์เป็นเอนทิตีแบบคงที่ซึ่งมีการกำหนดองค์ประกอบด้วยตนเองในระหว่างการพัฒนาเฟรมเวิร์ก Android รุ่นถัดไป
- รายการเฟรมเวิร์ก อธิบายบริการระดับสูงที่เฟรมเวิร์กสามารถมอบให้กับอุปกรณ์ได้
- เมทริกซ์ความเข้ากันได้ของอุปกรณ์ อธิบายถึงบริการที่อิมเมจของผู้จำหน่ายต้องการสำหรับเฟรมเวิร์ก องค์ประกอบจะถูกกำหนดด้วยตนเองในระหว่างการพัฒนาอุปกรณ์
รายการและเมทริกซ์ทั้งสองคู่นี้จะต้องกระทบยอดในเวลา OTA เพื่อให้แน่ใจว่าอุปกรณ์สามารถรับการอัปเดตเฟรมเวิร์กที่เข้ากันได้กับความสามารถของอุปกรณ์ โดยทั่วไป รายการ จะอธิบายสิ่งที่มีให้ และ เมทริกซ์ความเข้ากันได้ จะอธิบายสิ่งที่จำเป็น
ส่วนนี้ประกอบด้วยรายละเอียดต่อไปนี้เกี่ยวกับรายการและเมทริกซ์:
- รายการ จะกำหนดรายการอุปกรณ์ รายการเฟรมเวิร์ก และสคีมาไฟล์รายการ
- เมทริกซ์ความเข้ากันได้ กำหนดสคีมาสำหรับเมทริกซ์ความเข้ากันได้
- วงจรชีวิต FCM ให้รายละเอียดว่า HIDL HAL เลิกใช้และลบอย่างไร และวิธีแก้ไขไฟล์ FCM เพื่อให้สะท้อนถึงสถานะของเวอร์ชัน HAL
- การพัฒนา DM อธิบายวิธีที่ผู้จำหน่ายสามารถกำหนดและประกาศเวอร์ชัน FCM เป้าหมายในรายการอุปกรณ์สำหรับอุปกรณ์ใหม่ หรือใช้เวอร์ชัน HAL ใหม่ และเพิ่มเวอร์ชัน Target FCM เมื่ออัปเกรดอิมเมจของผู้จำหน่ายสำหรับอุปกรณ์เก่า
- กฎการจับคู่ กำหนดกฎสำหรับการจับคู่ที่ประสบความสำเร็จระหว่างเมทริกซ์ความเข้ากันได้และรายการ