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

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

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

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

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

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

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

ออบเจ็กต์ VINTF จะต้องเชื่อถือได้และให้ข้อมูลที่ครบถ้วนเหมือนกันโดยไม่คำนึงถึงเวลาที่ร้องขออ็อบเจ็กต์ (ดูคำ เตือน )

คำแสดงและเมทริกซ์

สำหรับ Android 8.0 นั้น API รันไทม์จะสอบถามว่ามีอะไรอยู่ในอุปกรณ์และส่งข้อมูลนั้นไปยังเซิร์ฟเวอร์อัปเดต Over-the-Air (OTA) และผู้สนใจอื่นๆ (เช่น CTS DeviceInfo ) ข้อมูลบางอย่างถูกดึงมาที่รันไทม์และบางส่วนถูกกำหนดแบบสแตติก

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

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

ส่วนนี้ประกอบด้วยรายละเอียดต่อไปนี้เกี่ยวกับรายการและเมทริกซ์:

• Manifests กำหนดรายการอุปกรณ์ รายการเฟรมเวิร์ก และสคีมาไฟล์รายการ
• เมทริกซ์ความเข้า กันได้ กำหนดสคีมาสำหรับเมทริกซ์ความเข้ากันได้
• FCM Lifecycle ให้รายละเอียดว่า HIDL HAL ถูกเลิกใช้และลบอย่างไร และไฟล์ FCM ถูกแก้ไขอย่างไรเพื่อแสดงสถานะของเวอร์ชัน HAL
• การพัฒนา DM อธิบายวิธีที่ผู้จำหน่ายสามารถกำหนดและประกาศเวอร์ชัน FCM เป้าหมายในรายการอุปกรณ์สำหรับอุปกรณ์ใหม่หรือใช้เวอร์ชัน HAL ใหม่ และเพิ่มเวอร์ชัน FCM เป้าหมายเมื่ออัปเกรดอิมเมจผู้ขายสำหรับอุปกรณ์เก่า
• กฎการ จับคู่ กำหนดกฎสำหรับการจับคู่ที่ประสบความสำเร็จระหว่างเมทริกซ์ความเข้ากันได้และรายการ