Os recursos a seguir fornecem detalhes sobre locais de código, ferramentas, testes, e licenciamento.
Local do código consultável
O código do objeto de interface do fornecedor consultável vai para
system/libvintf
:
Ferramentas
Arquivos de manifesto de escrita à mão e matrizes de compatibilidade podem ser difíceis. Use o as ferramentas a seguir para gerar uma matriz boilerplate de manifesto/compatibilidade para começar se originou.
LsHAL
A LSHAL é uma ferramenta do lado do dispositivo que lista todas as HALs registradas para
hwservicemanager
e todas as implementações de passagem disponíveis
(por exemplo, android.hardware.foo@1.0-impl.so
) no dispositivo. Ela também pode
gere um arquivo de manifesto do dispositivo com base na lista:
adb shell su 0 /system/bin/lshal --init-vintf
Observe o seguinte:
- Se um pacote estiver registrado no
hwservicemanager
e encontrado como uma HAL de passagem,<transport>
é definido comohwbinder
- Nenhuma versão do SELinux está gravada no manifesto. Sugere-se que o
é injetado por
assemble_vintf
, conforme explicado abaixo. - O arquivo de manifesto da HAL gerado pode estar impreciso. A atenção humana é
para corrigir inconsistências entre o manifesto do dispositivo e o que
vendor.img
oferece.
ASSEMBLE_VINTF
assemble_vintf
é uma ferramenta do lado do host que:
- Verifica se uma matriz de compatibilidade ou um arquivo de manifesto é válido.
- Injeta variáveis em manifestos/matrizes de compatibilidade disponíveis no build e gera um novo arquivo que deve ser instalado no dispositivo.
- Verifica a compatibilidade entre o arquivo gerado e a cópia dele.
- Se um arquivo de manifesto for fornecido, poderá gerar um código boilerplate matricial de compatibilidade compatível com o arquivo de manifesto.
Exemplo:gerar compatibilidade de dispositivo matricial de um arquivo de manifesto de framework
assemble_vintf -m --hals-only \ -i system/libhidl/manifest.xml \ -o device/manufacturer/device_name/compatibility_matrix.xml
Todas as HALs estão definidas como optional="true"
.
Exemplo:gerar um esqueleto de compatibilidade de framework matriz de um arquivo de manifesto do dispositivo
assemble_vintf -m --hals-only \ -i device/foo/bar/manifest.xml \ -o path/to/place/output/compatibility_matrix.xml
Todas as HALs estão definidas como optional="true"
.
Exemplo:gerar arquivos XML de manifesto do dispositivo usando variáveis
No tempo de build, se as variáveis a seguir forem
definido em device/manufacturer/device_name/BoardConfig.mk
:
# Vendor manifest is named DEVICE_MANIFEST_FILE for legacy reasons. DEVICE_MANIFEST_FILE := \ device/manufacturer/device_name/vendor_manifest.xml ODM_MANIFEST_FILES := \ device/manufacturer/device_name/odm_manifest.xml ODM_MANIFEST_SKUS := sku1 sku2 ODM_MANIFEST_SKU1_FILES := \ device/manufacturer/device_name/odm_manifest_sku1.xml ODM_MANIFEST_SKU2_FILES := \ device/manufacturer/device_name/odm_manifest_sku2.xml
Em seguida, os comandos a seguir são executados (no sistema de build, modificados para omitir a implementação detalhes) para gerar arquivos XML de manifesto do dispositivo:
# vendor manifest; only when DEVICE_MANIFEST_FILE is set BOARD_SEPOLICY_VERS=$(BOARD_SEPOLICY_VERS) assemble_vintf \ $(addprefix,-i ,$(DEVICE_MANIFEST_FILE)) \ -o $(TARGET_OUT_VENDOR)/etc/vintf/manifest.xml # ODM manifests assemble_vintf \ $(addprefix,-i ,$(ODM_MANIFEST_FILES)) \ -o $(TARGET_OUT_ODM)/etc/vintf/manifest.xml # ODM manifests for each sku assemble_vintf \ $(addprefix,-i ,$(ODM_MANIFEST_SKU1_FILES)) \ -o $(TARGET_OUT_ODM)/etc/vintf/manifest_sku1.xml assemble_vintf \ $(addprefix,-i ,$(ODM_MANIFEST_SKU2_FILES)) \ -o $(TARGET_OUT_ODM)/etc/vintf/manifest_sku2.xml
No tempo de execução, o objeto VINTF combina manifestos do fornecedor e manifestos ODM como manifesto do dispositivo. Consulte Dispositivo manifesto do app para mais detalhes.
Exemplo:gerar arquivos XML da matriz de compatibilidade do dispositivo usando variáveis
No tempo de build, se as variáveis a seguir forem
definido em device/manufacturer/device_name/BoardConfig.mk
:
# vendor compatibility matrix is named DEVICE_MATRIX_FILE for legacy reasons. DEVICE_MATRIX_FILE := \ device/manufacturer/device_name/vendor_compatibility_matrix.xml \ device/manufacturer/device_name/vendor_compatibility_matrix_additional.xml
Em seguida, os comandos a seguir são executados (no sistema de build, modificados para omitir a implementação detalhes) para gerar arquivos XML da matriz de compatibilidade do dispositivo:
# vendor compatibility matrix; only when DEVICE_MATRIX_FILE is set assemble_vintf \ $(addprefix,-i ,$(DEVICE_MATRIX_FILE)) \ -o $(TARGET_OUT_VENDOR)/etc/vintf/compatibility_matrix.xml
No tempo de execução, o objeto VINTF usa a matriz de compatibilidade do fornecedor como o matriz de compatibilidade de dispositivos. Consulte Dispositivo matriz de compatibilidade para mais detalhes.
Exemplo:gerar arquivos XML de manifesto do framework com base em variáveis
As variáveis a seguir podem ser definidas em
device/manufacturer/device_name/BoardConfig.mk
:
# Device-specific system manifest is named DEVICE_FRAMEWORK_MANIFEST_FILE for legacy reasons DEVICE_FRAMEWORK_MANIFEST_FILE := \ device/manufacturer/device_name/device_system_manifest.xml # Product manifest PRODUCT_MANIFEST_FILES := \ device/manufacturer/device_name/product_manifest.xml
Os comandos a seguir são executados (no sistema de build, modificados para omitir a implementação detalhes) para gerar arquivos XML de manifesto de framework:
# system manifest assemble_vintf \ -i system/libhidl/vintfdata/manifest.xml \ $(addprefix,-i ,$(DEVICE_FRAMEWORK_MANIFEST_FILE)) \ -o $(TARGET_OUT)/etc/vintf/manifest.xml # product manifest assemble_vintf \ $(addprefix,-i ,$(PRODUCT_MANIFEST_FILES)) \ -o $(TARGET_OUT_PRODUCT)/etc/vintf/manifest.xml
No tempo de execução, o objeto VINTF combina o manifesto do sistema, o manifesto do sistema fragmentos, manifesto de produto e fragmentos de manifesto de produto como o manifesto do framework. Consulte Estrutura manifesto do app para mais detalhes.
Exemplo:gerar arquivos XML da matriz de compatibilidade do framework com base em variáveis
As variáveis a seguir podem ser definidas em
device/manufacturer/device_name/BoardConfig.mk
para definir o FCM do produto e
FCM de sistema específico do dispositivo:
DEVICE_PRODUCT_COMPATIBILITY_MATRIX_FILE := \ device/manufacturer/device_name/product_compatibility_matrix.xml # Device-specific system compatibility matrix is named # DEVICE_FRAMEWORK_COMPATIBILITY_MATRIX_FILE for legacy reasons. DEVICE_FRAMEWORK_COMPATIBILITY_MATRIX_FILE := \ device/manufacturer/device_name/device_system_compatibility_matrix.xml
O FCM system_ext precisa ser instalado com os módulos Soong. O FCM do produto também pode estar instalado
com os módulos do Soong. não defina DEVICE_PRODUCT_COMPATIBILITY_MATRIX_FILE
se este
é usado. Além disso, várias versões do FCM de produto e versões system_ext do FCM podem ser
instalado com os módulos Soong.
Defina o seguinte:
-
Defina um módulo em
device/manufacturer/device_name/Android.bp
. Por exemplo (substitua system_ext com produto para produto FCM):vintf_compatibility_matrix { name: "system_ext_compatibility_matrix.xml", stem: "compatibility_matrix.xml", system_ext_specific: true, // product_specific: true, // for product FCM srcs: [ "system_ext_compatibility_matrix.xml", ], }
-
Instale o módulo em
device/manufacturer/device_name/device.mk
. Exemplo:PRODUCT_PACKAGES += system_ext_compatibility_matrix.xml
Os comandos a seguir são executados (no sistema de build, modificados para omitir a implementação detalhes) para gerar arquivos XML da matriz de compatibilidade do framework:
# common system compatibility matrix for each FCM version BOARD_SEPOLICY_VERS=$(BOARD_SEPOLICY_VERS) \ POLICYVERS=$(POLICYVERS) \ BOARD_AVB_VBMETA_VERSION=$(BOARD_AVB_VBMETA_VERSION) assemble_vintf \ -i hardware/interfaces/compatibility_matrices/compatibility_matrix.empty.xml $(addprefix,-i ,$(DEVICE_FRAMEWORK_COMPATIBILITY_MATRIX_FILE)) \ -o $(TARGET_OUT)/etc/vintf/compatibility_matrix.device.xml # framework compatibility matrixes at each FCM version assemble_vintf -i hardware/interfaces/compatibility_matrices/compatibility_matrix.{level}.xml \ -o $(TARGET_OUT)/etc/vintf/compatibility_matrix.{level}.xml \ --kernel=... # product framework compatibility matrix; only when # DEVICE_PRODUCT_COMPATIBILITY_MATRIX_FILE is set or when the Soong module for # product FCM is defined assemble_vintf -i $(DEVICE_PRODUCT_COMPATIBILITY_MATRIX_FILE) -o $(TARGET_OUT_PRODUCT)/etc/vintf/compatibility_matrix.xml # system_ext framework compatibility matrix; only when the Soong module for # system_ext FCM is defined assemble_vintf -i <srcs for the soong module> -o $(TARGET_OUT_SYSTEM_EXT)/etc/vintf/compatibility_matrix.xml
No tempo de execução, o objeto VINTF combina um subconjunto de elementos de compatibilidade do sistema matriciais e de compatibilidade de produtos como o framework de compatibilidade matricial. Consulte Estrutura matriz de compatibilidade para mais detalhes.
Exemplo: Gerar o manifesto do fornecedor com base em fragmentos
Vários fragmentos de manifesto do fornecedor podem ser agrupados no tempo de build. Exemplo:
<!-- device/manufacturer/device_name/manifest_common.xml --> <manifest version="1.0" type="device"> <!-- common HALs here --> </manifest>
<!-- device/manufacturer/device_name/ir.xml --> <manifest version="1.0" type="device"> <hal> <name>android.hardware.ir</name> <version>1.0</version> <!-- other fields --> </hal> </manifest>
# device/manufacturer/device_name/BoardConfig.mk DEVICE_MANIFEST_FILE := device/manufacturer/device_name/manifest_common.xml ifdef BOARD_ENABLE_IR DEVICE_MANIFEST_FILE += device/manufacturer/device_name/ir.xml endif
Em seguida, assemble_vintf
adiciona a HAL de IR ao manifesto do fornecedor se
BOARD_ENABLE_IR
está definido e a omite se
BOARD_ENABLE_IR
não está definido. Os comandos a seguir
(modificado para omitir detalhes de implementação) são executados para gerar o manifesto do fornecedor:
# if BOARD_ENABLE_IR is defined BOARD_SEPOLICY_VERS=10000.0 assemble_vintf \ -i device/manufacturer/device_name/manifest_common.xml:device/manufacturer/device_name/ir.xml \ -o $(TARGET_OUT_VENDOR)/manifest.xml # if BOARD_ENABLE_IR is not defined BOARD_SEPOLICY_VERS=10000.0 assemble_vintf \ -i device/manufacturer/device_name/manifest_common.xml \ -o $(TARGET_OUT_VENDOR)/manifest.xml
Para obter informações, consulte:
assemble_vintf --help
Teste
O projeto platform/system/libvintf
usa
GTest para
serialização, desserialização e verificação de compatibilidade.
Licenciamento
tinyxml2
(external/tinyxml2) para serializar/desserializar o de/para XML. tipo BSD.libselinux
(external/selinux/libselinux) para receber o policydb. para a versão anterior. Licença de domínio público.libz
(externo/zlib) para descompactação/proc/config.gz
. tipo BSD.- O projeto
libvintf
usa a licença Apache 2.0 (com os devidos MODULE_LICENSE_APACHE2 e arquivos NOTICE).