Objeto de interface do fornecedor

Este documento descreve o design do objeto de interface do fornecedor ( objeto VINTF), que agrega informações relevantes sobre um dispositivo e as disponibiliza por meio de uma API consultável .

Projeto de objeto VINTF

Um objeto VINTF reúne algumas das informações de que precisa diretamente do dispositivo. Outros aspectos, como os manifestos, são descritos estaticamente em XML.

Figura 1. Manifestos, matrizes de compatibilidade e informações coletáveis ​​em tempo de execução

O projeto de objeto VINTF fornece o seguinte para componentes de dispositivo e estrutura:

Para o Dispositivo

Para a estrutura

Define um esquema para o componente estático (o arquivo de manifesto do dispositivo ). Adiciona suporte de tempo de construção para definir o arquivo de manifesto do dispositivo para um determinado dispositivo. Define a API consultável em tempo de execução que recupera o arquivo de manifesto do dispositivo (junto com as outras informações coletáveis em tempo de execução) e os empacota no resultado da consulta.

Define um esquema para o componente estático (o arquivo de manifesto da estrutura ). Define a API consultável em tempo de execução que recupera o arquivo de manifesto da estrutura e o empacota no resultado da consulta.

O objeto VINTF deve ser confiável e fornecer as mesmas informações completas, independentemente de quando o objeto é solicitado (consulte Advertências ).

Manifestos e matrizes

A partir do Android 8.0, uma API de tempo de execução consulta o que está no dispositivo e envia essas informações para o servidor de atualização Over-the-Air (OTA) e outras partes interessadas (como CTS DeviceInfo ). Algumas informações são recuperadas em tempo de execução e outras são definidas estaticamente.

• O manifesto do dispositivo descreve o componente estático do que o dispositivo pode fornecer à estrutura.
• A matriz de compatibilidade da estrutura descreve o que a estrutura do Android espera de um determinado dispositivo. A matriz é uma entidade estática cuja composição é determinada manualmente durante o desenvolvimento da próxima versão da estrutura Android.
• O manifesto da estrutura descreve serviços de alto nível que a estrutura pode fornecer ao dispositivo.
• A matriz de compatibilidade de dispositivo descreve os serviços que a imagem do fornecedor exige da estrutura. Sua composição é determinada manualmente durante o desenvolvimento do dispositivo.

Esses dois pares de manifestos e matrizes devem ser reconciliados no momento da OTA para garantir que um dispositivo possa obter atualizações de estrutura compatíveis com os recursos do dispositivo. Em geral, um manifesto descreve o que é fornecido e uma matriz de compatibilidade descreve o que é necessário.

Esta seção inclui os seguintes detalhes sobre manifestos e matrizes:

• Os manifestos definem o manifesto do dispositivo, o manifesto da estrutura e o esquema do arquivo de manifesto.
• Matrizes de compatibilidade define o esquema para a matriz de compatibilidade.
• FCM Lifecycle detalha como HIDL HALs foram descontinuados e removidos e como arquivos FCM são modificados para refletir o status da versão HAL.
• O DM Development descreve como os fornecedores podem definir e declarar a versão do FCM de destino no manifesto do dispositivo para novos dispositivos ou implementar novas versões de HAL e incrementar a versão do FCM de destino ao atualizar a imagem do fornecedor para dispositivos antigos.
• Regras de correspondência definem as regras para uma correspondência bem-sucedida entre uma matriz de compatibilidade e um manifesto.