Следующие ресурсы предоставляют подробную информацию о расположении кода, инструментах, тестировании и лицензировании.
Запрашиваемое расположение кода
Код для запрашиваемого объекта интерфейса поставщика находится в system/libvintf
(см. Запрашиваемый API ).
Инструменты
Рукописный ввод файлов манифеста и матриц совместимости может оказаться сложной задачей. Используйте следующие инструменты, чтобы сгенерировать шаблонный манифест / матрицу совместимости.
ЛШАЛ
LSHAL - это инструмент на стороне устройства, который перечисляет все зарегистрированные HAL для hwservicemanager
и все доступные реализации сквозной 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
деле предоставляет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 установлено значение optional="true"
.
Пример: создание матрицы совместимости каркасной платформы из файла манифеста устройства
assemble_vintf -m --hals-only \ -i device/foo/bar/manifest.xml \ -o path/to/place/output/compatibility_matrix.xml
Обратите внимание, что для всех HAL установлено значение 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/manufacturer/device_name/BoardConfig.mk
от устройства:
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 в манифест поставщика , если 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
(external / tinyxml2) для сериализации / десериализации объекта в / из XML. BSD-подобная лицензия. -
libselinux
(external / selinux / libselinux) для получения версии policydb. Лицензия общественного достояния. -
libz
(external / zlib) для распаковки/proc/config.gz
. BSD-подобная лицензия. -
libvintf
проектеlibvintf
используется лицензия Apache 2.0 (с соответствующими файлами MODULE_LICENSE_APACHE2 и NOTICE).