Objek Antarmuka Penjual

Dokumen ini menjelaskan desain objek antarmuka vendor (objek VINTF), yang mengumpulkan informasi yang relevan tentang perangkat dan membuat informasi tersebut tersedia melalui API yang dapat diminta.

Desain objek VINTF

Objek VINTF mengumpulkan beberapa informasi yang dibutuhkan langsung dari perangkat. Aspek lain, seperti manifes, dijelaskan secara statis dalam XML.

Gambar 1. Manifes, matriks kompatibilitas, dan informasi runtime-collectible

Desain objek VINTF menyediakan yang berikut untuk komponen perangkat dan kerangka kerja:

Untuk Perangkat Untuk Kerangka
  • Mendefinisikan skema untuk komponen statis ( file manifes perangkat ).
  • Menambahkan dukungan waktu pembuatan untuk menentukan file manifes perangkat untuk perangkat tertentu.
  • Mendefinisikan API yang dapat dikueri pada waktu proses yang mengambil file manifes perangkat (bersama dengan informasi yang dapat dikumpulkan waktu proses lainnya) dan mengemasnya ke dalam hasil kueri.

Objek VINTF harus dapat diandalkan dan memberikan informasi lengkap yang sama terlepas dari kapan objek diminta (lihat Peringatan ).

Manifes & matriks

Mulai Android 8.0, API runtime menanyakan apa yang ada di perangkat dan mengirimkan informasi itu ke server pembaruan Over-the-Air (OTA) dan pihak berkepentingan lainnya (seperti CTS DeviceInfo ). Beberapa informasi diambil pada saat runtime dan beberapa di antaranya didefinisikan secara statis.

  • Manifes perangkat menjelaskan komponen statis dari apa yang dapat diberikan perangkat ke kerangka kerja.
  • Matriks kompatibilitas kerangka kerja menjelaskan apa yang diharapkan kerangka kerja Android dari perangkat tertentu. Matriks adalah entitas statis yang komposisinya ditentukan secara manual selama pengembangan rilis kerangka kerja Android berikutnya.
  • Manifes kerangka kerja menjelaskan layanan tingkat tinggi yang dapat diberikan kerangka kerja ke perangkat.
  • Matriks kompatibilitas perangkat menjelaskan layanan yang dibutuhkan oleh gambar vendor dari kerangka kerja. Komposisinya ditentukan secara manual selama pengembangan perangkat.

Kedua pasang manifes dan matriks ini harus direkonsiliasi pada waktu OTA untuk memastikan perangkat bisa mendapatkan pembaruan kerangka kerja yang kompatibel dengan kemampuan perangkat. Secara umum, manifes menjelaskan apa yang disediakan dan matriks kompatibilitas menjelaskan apa yang diperlukan.

Bagian ini mencakup detail berikut tentang manifes dan matriks:

  • Manifes mendefinisikan manifes perangkat, manifes kerangka kerja, dan skema file manifes.
  • Matriks Kompatibilitas mendefinisikan skema untuk matriks kompatibilitas.
  • Siklus Hidup FCM merinci bagaimana HIDL HAL tidak digunakan lagi dan dihapus dan bagaimana file FCM dimodifikasi untuk mencerminkan status Versi HAL.
  • Pengembangan DM menjelaskan bagaimana vendor dapat menentukan dan mendeklarasikan Versi FCM Target dalam manifes perangkat untuk perangkat baru atau mengimplementasikan versi HAL baru dan meningkatkan Versi Target FCM saat memutakhirkan citra vendor untuk perangkat lama.
  • Aturan Pencocokan menentukan aturan untuk kecocokan yang berhasil antara matriks kompatibilitas dan manifes.