كائن واجهة البائع

يصف هذا المستند تصميم كائن واجهة البائع (كائن VINTF)، الذي يجمع المعلومات ذات الصلة بالجهاز ويجعل هذه المعلومات متاحة من خلال واجهة برمجة تطبيقات قابلة للاستعلام .

تصميم كائن VINTF

يقوم كائن VINTF بجمع بعض المعلومات التي يحتاجها مباشرة من الجهاز. يتم وصف الجوانب الأخرى، مثل البيانات، بشكل ثابت في XML.

الشكل 1. البيانات ومصفوفات التوافق والمعلومات القابلة للتحصيل في وقت التشغيل

يوفر تصميم كائن VINTF ما يلي لمكونات الجهاز وإطار العمل:

للجهاز بالنسبة للإطار
  • يحدد مخططًا للمكون الثابت ( ملف بيان الجهاز ).
  • يضيف دعم وقت البناء لتحديد ملف بيان الجهاز لجهاز معين.
  • يحدد واجهة برمجة التطبيقات القابلة للاستعلام في وقت التشغيل والتي تسترد ملف بيان الجهاز (مع المعلومات الأخرى القابلة للتحصيل في وقت التشغيل) وتجميعها في نتيجة الاستعلام.

يجب أن يكون كائن VINTF موثوقًا به ويقدم نفس المعلومات الكاملة بغض النظر عن وقت طلب الكائن (راجع التحذيرات ).

البيانات والمصفوفات

اعتبارًا من Android 8.0، تستعلم واجهة برمجة تطبيقات وقت التشغيل عما هو موجود على الجهاز وترسل تلك المعلومات إلى خادم التحديث عبر الأثير (OTA) والأطراف المعنية الأخرى (مثل CTS DeviceInfo ). يتم استرداد بعض المعلومات في وقت التشغيل ويتم تعريف بعضها بشكل ثابت.

  • يصف بيان الجهاز المكون الثابت لما يمكن أن يوفره الجهاز لإطار العمل.
  • تصف مصفوفة توافق إطار العمل ما يتوقعه إطار عمل Android من جهاز معين. المصفوفة عبارة عن كيان ثابت يتم تحديد تكوينه يدويًا أثناء تطوير الإصدار التالي من إطار عمل Android.
  • يصف بيان إطار العمل الخدمات عالية المستوى التي يمكن أن يوفرها إطار العمل للجهاز.
  • تصف مصفوفة توافق الجهاز الخدمات التي تتطلبها صورة البائع من إطار العمل. يتم تحديد تركيبته يدويًا أثناء تطوير الجهاز.

يجب التوفيق بين هذين الزوجين من البيانات والمصفوفات في وقت OTA لضمان حصول الجهاز على تحديثات إطار العمل المتوافقة مع إمكانيات الجهاز. بشكل عام، يصف البيان ما يتم توفيره وتصف مصفوفة التوافق ما هو مطلوب.

يتضمن هذا القسم التفاصيل التالية عن البيانات والمصفوفات:

  • تحدد البيانات بيان الجهاز وبيان إطار العمل ومخطط ملف البيان.
  • تحدد مصفوفات التوافق مخطط مصفوفة التوافق.
  • توضح دورة حياة FCM كيفية إهمال وإزالة HIDL HALs وكيفية تعديل ملفات FCM لتعكس حالة إصدار HAL.
  • يصف تطوير DM كيف يمكن للبائعين تحديد وإعلان إصدار FCM المستهدف في بيان الجهاز للأجهزة الجديدة أو تنفيذ إصدارات HAL الجديدة وزيادة إصدار FCM المستهدف عند ترقية صورة البائع للأجهزة القديمة.
  • تحدد قواعد المطابقة قواعد المطابقة الناجحة بين مصفوفة التوافق والبيان.