Google is committed to advancing racial equity for Black communities. See how.
Эта страница была переведа с помощью Cloud Translation API.
Switch to English

Манифесты

Объект VINTF объединяет данные из манифеста устройства и файлов манифеста платформы (XML). Оба манифеста имеют общий формат, хотя не все элементы применимы к обоим (подробные сведения о схеме см. В разделе Схема файла манифеста ).

Манифест устройства

Манифест устройства (предоставляемый устройством) состоит из манифеста поставщика и манифеста ODM.

  • В манифесте поставщика указаны HAL, версии политики SELinux и т. Д., Общие для SoC. Рекомендуется разместить в дереве исходных device/ VENDOR / DEVICE /manifest.xml Android по адресу device/ VENDOR / DEVICE /manifest.xml , но можно использовать несколько файлов фрагментов. Для получения дополнительной информации см. Фрагменты манифеста и Создание DM из фрагментов .
  • В манифесте ODM перечислены HAL, относящиеся к продукту в разделе ODM . Объект VINTF загружает манифест ODM в следующем порядке:
    1. Если SKU определен (где SKU - это значение свойства ro.boot.product.hardware.sku ), /odm/etc/vintf/manifest_ SKU .xml
    2. /odm/etc/vintf/manifest.xml
    3. Если SKU определен, /odm/etc/manifest_ SKU .xml
    4. /odm/etc/manifest.xml
  • Объект VINTF загружает манифест устройства в следующем порядке:
    1. Если существует /vendor/etc/vintf/manifest.xml , объедините следующее:
      1. /vendor/etc/vintf/manifest.xml
      2. Необязательные фрагменты манифеста поставщика
      3. Дополнительный манифест ODM
      4. Необязательные фрагменты манифеста ODM
    2. В противном случае, если манифест ODM существует, объедините манифест ODM с дополнительными фрагментами манифеста ODM.
    3. /vendor/manifest.xml (устаревшая /vendor/manifest.xml , без фрагментов)

    Обратите внимание, что:

    • На устаревших устройствах используются устаревший манифест поставщика и манифест ODM. Манифест ODM может полностью заменить устаревший манифест поставщика.
    • На устройствах, запущенных с Android 9, манифест ODM объединен с манифестом поставщика.
    • При объединении списка манифестов, манифесты, которые появляются позже в списке, могут переопределять теги в манифестах, которые появляются раньше в списке, при условии, что теги в последнем манифесте имеют атрибут override="true" . Например, манифест ODM может переопределять некоторые теги <hal> из манифеста поставщика. См. Документацию по override атрибутов ниже.

Эта настройка позволяет нескольким продуктам с одной платой совместно использовать один и тот же образ поставщика (который предоставляет общие HAL), но при этом иметь разные образы ODM (которые определяют HAL для конкретного продукта).

Вот пример манифеста поставщика.

<?xml version="1.0" encoding="UTF-8"?>
<!-- Comments, Legal notices, etc. here -->
<manifest version="2.0" type="device" target-level="1">
    <hal>
        <name>android.hardware.camera</name>
        <transport>hwbinder</transport>
        <version>3.4</version>
        <interface>
            <name>ICameraProvider</name>
            <instance>legacy/0</instance>
            <instance>proprietary/0</instance>
        </interface>
    </hal>
    <hal>
        <name>android.hardware.nfc</name>
        <transport>hwbinder</transport>
        <version>1.0</version>
        <version>2.0</version>
        <interface>
            <name>INfc</name>
            <instance>nfc_nci</instance>
        </interface>
    </hal>
    <hal>
        <name>android.hardware.nfc</name>
        <transport>hwbinder</transport>
        <fqname>@2.0::INfc/default</fqname>
    </hal>
    <hal>
        <name>android.hardware.drm</name>
        <transport>hwbinder</transport>
        <version>1.0</version>
        <interface>
            <name>ICryptoFactory</name>
            <instance>default</instance>
        </interface>
        <interface>
            <name>IDrmFactory</name>
            <instance>default</instance>
        </interface>
        <fqname>@1.1::ICryptoFactory/clearkey</fqname>
        <fqname>@1.1::IDrmFactory/clearkey</fqname>
    </hal>
    <hal format="aidl">
        <name>android.hardware.light</name>
        <fqname>ILights/default</fqname>
    </hal>
    <hal format="aidl">
        <name>android.hardware.power</name>
        <interface>
            <name>IPower</name>
            <instance>default</instance>
        </interface>
    </hal>
    <hal format="native">
        <name>EGL</name>
        <version>1.1</version>
    </hal>
    <hal format="native">
        <name>GLES</name>
        <version>1.1</version>
        <version>2.0</version>
        <version>3.0</version>
    </hal>
    <sepolicy>
        <version>25.0</version>
    </sepolicy>
</manifest>

Вот пример манифеста ODM.

<?xml version="1.0" encoding="UTF-8"?>
<!-- Comments, Legal notices, etc. here -->
<manifest version="1.0" type="device">
    <!-- camera 3.4 in vendor manifest is ignored -->
    <hal override="true">
        <name>android.hardware.camera</name>
        <transport>hwbinder</transport>
        <version>3.5</version>
        <interface>
            <name>ICameraProvider</name>
            <instance>legacy/0</instance>
        </interface>
    </hal>
    <!-- NFC is declared to be disabled -->
    <hal override="true">
        <name>android.hardware.nfc</name>
        <transport>hwbinder</transport>
    </hal>
    <hal>
        <name>android.hardware.power</name>
        <transport>hwbinder</transport>
        <version>1.1</version>
        <interface>
            <name>IPower</name>
            <instance>default</instance>
        </interface>
    </hal>
</manifest>

Вот пример манифеста устройства в пакете OTA.

<?xml version="1.0" encoding="UTF-8"?>
<!-- Comments, Legal notices, etc. here -->
<manifest version="1.0" type="device" target-level="1">
    <!-- hals ommited -->
    <kernel version="4.4.176">
        <config>
            <key>CONFIG_ANDROID</key>
            <value>y</value>
        </config>
        <config>
            <key>CONFIG_ARM64</key>
            <value>y</value>
        </config>
    <!-- other configs ommited -->
    </kernel>
</manifest>

Дополнительные сведения см. В разделе « Разработка манифеста устройства» .

Манифест фреймворка

Файл манифеста платформы состоит из манифеста системы, манифеста продукта и манифеста system_ext.

  • Системный манифест (предоставленный Google) создается вручную и находится в дереве исходных /system/libhidl/manifest.xml Android по адресу /system/libhidl/manifest.xml .
  • В манифесте продукта (предоставляемом устройством) перечислены HAL, обслуживаемые модулями, установленными в разделе продукта.
  • В манифесте system_ext (предоставленном устройством) перечислено следующее:
    • HAL, обслуживаемые модулями, установленными в разделе system_ext;
    • Версии ВНДК;
    • Версия системного SDK.

Подобно манифесту устройства, можно использовать несколько файлов фрагментов. Подробнее см. Фрагменты манифеста .

Вот пример манифеста фреймворка.

<?xml version="1.0" encoding="UTF-8"?>
<!-- Comments, Legal notices, etc. here -->
<manifest version="1.0" type="framework">
    <hal>
        <name>android.hidl.allocator</name>
        <transport>hwbinder</transport>
        <version>1.0</version>
        <interface>
            <name>IAllocator</name>
            <instance>ashmem</instance>
        </interface>
    </hal>
    <hal>
        <name>android.hidl.memory</name>
        <transport arch="32+64">passthrough</transport>
        <version>1.0</version>
        <interface>
            <name>IMapper</name>
            <instance>ashmem</instance>
        </interface>
    </hal>
    <hal>
        <name>android.hidl.manager</name>
        <transport>hwbinder</transport>
        <version>1.0</version>
        <interface>
            <name>IServiceManager</name>
            <instance>default</instance>
        </interface>
    </hal>
    <hal>
        <name>android.frameworks.sensorservice</name>
        <transport>hwbinder</transport>
        <version>1.0</version>
        <interface>
            <name>ISensorManager</name>
            <instance>default</instance>
        </interface>
    </hal>
    <vendor-ndk>
        <version>27</version>
    </vendor-ndk>
    <system-sdk>
        <version>27</version>
    </system-sdk>
</manifest>

Фрагменты манифеста

В Android 10 и выше вы можете связать запись манифеста с модулем HAL в системе сборки. Это упрощает условное включение модуля HAL в систему сборки.

пример

В вашем файле Android.bp или Android.mk добавьте vintf_fragments к любому модулю. Например, вы можете изменить модуль с помощью своей реализации HAL ( my.package.foo@1.0-service-bar ).

... {
    ...
    vintf_fragments: ["manifest_foo.xml"],
    ...
}
LOCAL_MODULE := ...
LOCAL_VINTF_FRAGMENTS := manifest_foo.xml

В файле с именем manifest_foo.xml создайте манифест для этого модуля. Во время сборки этот манифест добавляется на устройство. Добавление записи здесь аналогично добавлению записи в основной манифест устройства. Это позволяет клиентам использовать интерфейс и позволяет VTS определять, какие реализации HAL установлены на устройстве. Все, что делает обычный манифест, делает и этот манифест.

В приведенном ниже примере реализуется android.hardware.foo@1.0::IFoo/default , который устанавливается в раздел vendor или odm . Если он установлен в раздел system , product или system_ext , используйте type framework вместо type device .

<manifest version="1.0" type="device">
    <hal format="hidl">
        <name>android.hardware.foo</name>
        <transport>hwbinder</transport>
        <fqname>@1.0::IFoo/default</fqname>
    </hal>
</manifest>

Схема файла манифеста

В этом разделе описывается значение этих тегов XML. Некоторые «обязательные» теги могут отсутствовать в исходном файле в дереве исходных текстов Android и записаны с помощью assemble_vintf во время сборки. Обязательные теги должны присутствовать в соответствующих файлах на устройстве.

?xml
По желанию. Предоставляет информацию только синтаксическому анализатору XML.
manifest.version
Необходимые. Мета-версия этого манифеста. Описывает элементы, ожидаемые в манифесте. Не связано с версией XML.
manifest.type
Необходимые. Тип этого манифеста. Он имеет device значения для файла манифеста устройства и framework для файла манифеста платформы.
manifest.target-level
Требуется для манифеста устройства. Задает версию матрицы совместимости платформы (FCM), с которой должен быть совместим этот манифест устройства. Это также называется поставляемой FCM-версией устройства.
manifest.hal
Необязательно, могу повторить. Один HAL (HIDL или собственный, например GL), в зависимости от атрибута format .
manifest.hal.format
По желанию. Значение может быть одним из:
  • hidl : HIDL HALs. Это значение по умолчанию.
  • aidl : AIDL HALs . Действует только в мета-версии манифеста 2.0 и выше.
  • native : Родные HAL.
manifest.hal.override
По желанию. Значение может быть одним из:
  • true : переопределить другие элементы <hal> с тем же <name> и основной версией. Если в этом элементе <hal> нет <version> или <fqname> , то элемент <hal> объявляет, что этот HAL отключен.
  • false : не переопределять другие элементы <hal> с тем же <name> и основной версией.
manifest.hal.name
Необходимые. Полное имя пакета HAL. Одно и то же имя можно использовать для нескольких записей HAL. Примеры:
  • android.hardware.camera (HIDL или AIDL HAL)
  • GLES (родной HAL, требуется только имя)
manifest.hal.transport
Требуется, если manifest.hal.format == "hidl" . В противном случае НЕ должен присутствовать. Указывает, какой транспорт используется, когда интерфейс из этого пакета запрашивается диспетчером служб. Значение может быть одним из:
  • hwbinder : биндеризованный режим
  • passthrough : режим passthrough передачи
manifest.hal.transport.arch
Требуется для passthrough hwbinder и не должен присутствовать для hwbinder . Описывает разрядность предоставляемой услуги сквозной передачи. Значение может быть одним из:
  • 32 : 32-битный режим
  • 64 : 64-битный режим
  • 32+64 : Оба
manifest.hal.version
Необязательно, могу повторить. Версия для тегов hal в манифесте. Формат MAJOR . MINOR . Примеры см. В разделах « hardware/interfaces , « vendor/${VENDOR}/interfaces , « framework/hardware/interfaces или « system/hardware/interfaces .

HIDL и собственные HAL могут использовать несколько полей версии, если они представляют разные основные версии , с предоставлением только одной дополнительной версии для каждой основной версии. Например, 3.1 и 3.2 не могут сосуществовать, но 1.0 и 3.4 могут. Это относится ко всем элементам hal с тем же именем, если override="true" .

Не должно присутствовать для AIDL HAL. <fqname> этого используйте <fqname> .
manifest.hal.interface
Обязательно, можно повторить без дубликатов. Укажите интерфейс в пакете с именем экземпляра. В <hal> может быть несколько элементов <interface> <hal> ; имена должны быть отличными.
manifest.hal.interface.name
Необходимые. Имя интерфейса.
manifest.hal.interface.instance
Обязательно, могу повторить. Имя экземпляра интерфейса. Может иметь несколько экземпляров интерфейса, но не дублировать элементы <instance> .
manifest.hal.fqname
Необязательно, могу повторить. Альтернативный способ указать экземпляр для HAL с именем manifest.hal.name .
  • Для HIDL HAL используется формат @ MAJOR . MINOR :: INTERFACE / INSTANCE .
  • Для AIDL HAL используется формат INTERFACE / INSTANCE .
manifest.sepolicy
Необходимые. Содержит все записи, связанные с политикой.
manifest.sepolicy.version
Требуется для манифеста устройства. Объявляет версию SELinux. Он имеет формат SDK_INT . PLAT_INT .
manifest.vendor-ndk
Обязательно, можно повторить; требуется для манифеста фреймворка. Не должно присутствовать в манифесте устройства. Несколько записей <vendor-ndk> должны иметь разные <version> . Описывает набор моментальных снимков VNDK, предоставляемых платформой.
manifest.vendor-ndk.version
Необходимые. Это положительное целое число, представляющее версию снимка VNDK.
manifest.vendor-ndk.library
Необязательно, может повторяться, без дубликатов. Описывает набор библиотек VNDK, предоставляемых платформой для этого моментального снимка поставщика VNDK. Значением является имя файла библиотеки, например libjpeg.so , включая префикс lib и суффикс .so . Компоненты пути не допускаются.
manifest.system-sdk.version
Необязательно, может повторяться, без дубликатов; используется только манифестом фреймворка. Описывает набор версий системного SDK, предоставляемых платформой для приложений-поставщиков.
manifest.kernel
По желанию. Описывает статическую информацию о ядре.
manifest.kernel.target-level
По желанию. Описывает ветку ядра. Его значение по умолчанию - manifest.target-level если оно отсутствует. Должен быть больше или равен manifest.target-level . См. Подробности в правилах соответствия ядра .