วัตถุส่วนต่อประสานผู้ขาย

เอกสารนี้อธิบายการออกแบบ ออบเจ็กต์อินเทอร์เฟซผู้ขาย (ออบเจ็กต์ VINTF) ซึ่งรวบรวมข้อมูลที่เกี่ยวข้องเกี่ยวกับอุปกรณ์และทำให้ข้อมูลนั้นพร้อมใช้งานผ่าน API ที่สามารถสืบค้นได้

การออกแบบวัตถุ VINTF

วัตถุ VINTF รวบรวมข้อมูลบางส่วนที่ต้องการโดยตรงจากอุปกรณ์ ลักษณะอื่นๆ เช่น รายการ ได้รับการอธิบายแบบคงที่ในรูปแบบ XML

รูปที่ 1 รายการ เมทริกซ์ความเข้ากันได้ และข้อมูลรันไทม์ที่รวบรวมได้

การออกแบบอ็อบเจ็กต์ VINTF ให้สิ่งต่อไปนี้สำหรับอุปกรณ์และส่วนประกอบของเฟรมเวิร์ก:

สำหรับอุปกรณ์ สำหรับกรอบการทำงาน
  • กำหนดสคีมาสำหรับองค์ประกอบคงที่ ( ไฟล์รายการอุปกรณ์ )
  • เพิ่มการสนับสนุนเวลาในการสร้างสำหรับการกำหนดไฟล์รายการอุปกรณ์สำหรับอุปกรณ์ที่กำหนด
  • กำหนด API ที่สามารถสืบค้นได้ ที่รันไทม์ซึ่งจะดึงไฟล์รายการอุปกรณ์ (พร้อมกับข้อมูลที่รวบรวมได้รันไทม์อื่นๆ) และจัดแพคเกจไว้ในผลลัพธ์การสืบค้น

อ็อบเจ็กต์ 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 เมื่ออัปเกรดอิมเมจของผู้จำหน่ายสำหรับอุปกรณ์เก่า
  • กฎการจับคู่ กำหนดกฎสำหรับการจับคู่ที่ประสบความสำเร็จระหว่างเมทริกซ์ความเข้ากันได้และรายการ