Objet de l'interface du fournisseur

Ce document décrit la conception de l'objet interface fournisseur (objet VINTF), qui agrège les informations pertinentes sur un appareil et les met à disposition via une API interrogable.

Conception de l'objet VINTF

Un objet VINTF rassemble certaines des informations dont il a besoin directement à partir de l'appareil. D'autres aspects, tels que les fichiers manifestes, sont décrits de manière statique en XML.

Figure 1 : Les fichiers manifestes, les matrices de compatibilité et les informations collectables au moment de l'exécution.

La conception d'objets VINTF fournit les éléments suivants pour les composants de l'appareil et du framework:

Pour l'appareil Pour le framework
  • Définit un schéma pour le composant statique (le fichier manifeste de l'appareil).
  • Ajout de la prise en charge du temps de compilation pour définir le fichier manifeste de l'appareil pour un appareil donné.
  • Définit l'API interrogable au moment de l'exécution, qui récupère le fichier manifeste de l'appareil (avec les autres informations collectables au moment de l'exécution) et les regroupe dans le résultat de la requête.
  • Définit un schéma pour le composant statique (le fichier manifeste du framework).
  • Définit l'API interrogable au moment de l'exécution, qui récupère le fichier manifeste du framework et le met en package dans le résultat de la requête.

L'objet VINTF doit être fiable et fournir les mêmes informations complètes, quel que soit le moment où l'objet est demandé (voir la section Avertissements).

Fichiers manifestes et matrices

Depuis Android 8.0, une API d'exécution interroge ce qui se trouve sur l'appareil et envoie ces informations au serveur de mise à jour Over-the-Air (OTA) et aux autres parties intéressées (telles que CTS DeviceInfo). Certaines informations sont récupérées au moment de l'exécution et d'autres sont définies de manière statique.

  • Le fichier manifeste de l'appareil décrit le composant statique de ce que l'appareil peut fournir au framework.
  • La matrice de compatibilité du framework décrit ce que le framework Android attend d'un appareil donné. La matrice est une entité statique dont la composition est déterminée manuellement lors du développement de la prochaine version du framework Android.
  • Le fichier manifeste du framework décrit les services de haut niveau que le framework peut fournir à l'appareil.
  • La matrice de compatibilité des appareils décrit les services que l'image du fournisseur exige du framework. Sa composition est déterminée manuellement lors du développement de l'appareil.

Ces deux paires de fichiers manifestes et de matrices doivent être réconciliées au moment de la mise à jour OTA pour s'assurer qu'un appareil peut recevoir des mises à jour de framework compatibles avec ses fonctionnalités. En général, un fichier manifeste décrit ce qui est fourni, et une matrice de compatibilité décrit ce qui est requis.

Cette section inclut les informations suivantes sur les fichiers manifestes et les matrices:

  • Manifestes définit le fichier manifeste de l'appareil, le fichier manifeste du framework et le schéma du fichier manifeste.
  • Matrices de compatibilité définit le schéma de la matrice de compatibilité.
  • Le cycle de vie de FCM explique comment les HAL HIDL sont obsolètes et supprimées, et comment les fichiers FCM sont modifiés pour refléter l'état de la version HAL.
  • Développement DM décrit comment les fournisseurs peuvent définir et déclarer la version FCM cible dans le fichier manifeste de l'appareil pour les nouveaux appareils, ou implémenter de nouvelles versions HAL et incrémenter la version FCM cible lors de la mise à niveau de l'image du fournisseur pour les anciens appareils.
  • Matching Rules (Règles de correspondance) définit les règles d'une correspondance réussie entre une matrice de compatibilité et un fichier manifeste.