Следующие ресурсы содержат подробные сведения о расположении кода, инструментах, тестировании и лицензировании.
Расположение запрашиваемого кода
Код запрашиваемого объекта интерфейса поставщика помещается в system/libvintf
(см. запрашиваемый API ).
Инструменты
Рукописные файлы манифеста и матрицы совместимости могут быть трудными. Используйте следующие инструменты для создания стандартного манифеста/матрицы совместимости.
ЛШАЛ
LSHAL — это инструмент на стороне устройства, который выводит список всех зарегистрированных HAL для hwservicemanager
и всех доступных сквозных реализаций (например, android.hardware.foo@1.0-impl.so
) на устройстве. Он также может генерировать файл манифеста устройства на основе списка:
adb shell su 0 /system/bin/lshal --init-vintf
Обратите внимание на следующее:
- Если пакет одновременно зарегистрирован в
hwservicemanager
и найден как транзитный HAL, для<transport>
устанавливается значениеhwbinder
. - Версия SELinux не записывается в манифест. Предполагается, что элемент вводится через
assemble_vintf
, как описано ниже. - Сгенерированный файл манифеста HAL может быть неточным. Требуется вмешательство человека, чтобы исправить несоответствия между манифестом устройства и тем, что на самом деле предоставляет
vendor.img
.
ASSEMBLE_VINTF
assemble_vintf
— это инструмент на стороне хоста, который:
- Проверяет допустимость матрицы совместимости или файла манифеста.
- Внедряет переменные в манифесты/матрицы совместимости, доступные во время сборки, и создает новый файл, который следует установить на устройство.
- Проверяет совместимость между сгенерированным файлом и его двойником.
- Если задан файл манифеста, дополнительно генерирует шаблонную матрицу совместимости, которая совместима с файлом манифеста.
Пример: создание матрицы совместимости устройств из файла манифеста платформы
assemble_vintf -m --hals-only \ -i system/libhidl/manifest.xml \ -o device/manufacturer/device_name/compatibility_matrix.xml
Обратите внимание, что для всех HAL установлено значение option optional="true"
.
Пример. Создайте матрицу совместимости каркаса из файла манифеста устройства.
assemble_vintf -m --hals-only \ -i device/foo/bar/manifest.xml \ -o path/to/place/output/compatibility_matrix.xml
Обратите внимание, что для всех HAL установлено значение option optional="true"
.
Пример: создание XML-файлов манифеста устройства из переменных
Во время сборки, если в 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
Затем выполняются следующие команды (в системе сборки, измененные, чтобы опустить детали реализации) для создания XML-файлов манифеста устройства:
# 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
Во время выполнения объект VINTF объединяет манифесты поставщиков и манифесты ODM в качестве манифеста устройства. Подробнее см. в манифесте устройства .
Пример: создание XML-файлов матрицы совместимости устройств из переменных
Во время сборки, если в 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
Затем выполняются следующие команды (в системе сборки, измененные, чтобы опустить детали реализации) для создания XML-файлов матрицы совместимости устройств:
# 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
Во время выполнения объект VINTF использует матрицу совместимости поставщиков в качестве матрицы совместимости устройств. Подробнее см. в таблице совместимости устройств .
Пример: создание XML-файлов манифеста платформы из переменных
В 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
Следующие команды выполняются (в системе сборки, измененной, чтобы опустить детали реализации) для создания XML-файлов манифеста платформы:
# 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
Во время выполнения объект VINTF объединяет манифест системы, фрагменты манифеста системы, манифест продукта и фрагменты манифеста продукта в качестве манифеста платформы. Подробнее см. в манифесте Framework .
Пример: создание XML-файлов матрицы совместимости фреймворка из переменных
Следующие переменные могут быть определены в device/manufacturer/device_name/BoardConfig.mk
для определения FCM продукта и FCM системы для конкретного устройства:
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
System_ext FCM должен быть установлен с модулями Soong. Продукт FCM также может быть установлен с модулями Soong; не определяйте DEVICE_PRODUCT_COMPATIBILITY_MATRIX_FILE
, если используется этот метод. Кроме того, с модулями Soong можно установить несколько версий продукта FCM и версий system_ext FCM. Определите следующее:
- Определите модуль в
device/manufacturer/device_name/Android.bp
. Например (замените system_ext на product для 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", ], }
- Установите модуль в
device/manufacturer/device_name/device.mk
. Например:PRODUCT_PACKAGES += system_ext_compatibility_matrix.xml
Следующие команды выполняются (в системе сборки, измененной, чтобы опустить детали реализации) для создания XML-файлов матрицы совместимости фреймворка:
# 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
Во время выполнения объект VINTF объединяет подмножество матриц совместимости систем и матриц совместимости продуктов в качестве матрицы совместимости платформы. Подробности см. в матрице совместимости фреймворков .
Пример: создание манифеста поставщика из фрагментов
Несколько фрагментов манифеста поставщика могут быть объединены во время сборки. Например:
<!-- 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
Затем assemble_vintf
добавляет HAL IR в манифест поставщика, если BOARD_ENABLE_IR
определен, и опускает его, если BOARD_ENABLE_IR
не определен. Следующие команды (измененные, чтобы опустить детали реализации) выполняются для создания манифеста поставщика:
# 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
Подробнее см.:
assemble_vintf --help
Тестирование
Проект platform/system/libvintf
использует GTest для сериализации, десериализации и проверки совместимости.
Лицензирование
-
tinyxml2
(внешний/tinyxml2) для сериализации/десериализации объекта в/из XML. BSD-подобная лицензия. -
libselinux
(external/selinux/libselinux) для получения версии policydb. Лицензия общественного достояния. -
libz
(external/zlib) для распаковки/proc/config.gz
. BSD-подобная лицензия. - Проект
libvintf
использует лицензию Apache 2.0 (с соответствующими файлами MODULE_LICENSE_APACHE2 и NOTICE).