清单

VINTF 对象会在系统运行时汇总设备清单框架清单文件 (XML) 中的数据以及设备本身的数据。这两个清单采用同一种格式,不过并非所有元素都适用于两者(有关架构方面的详细信息,请参阅清单文件架构)。

设备清单

设备清单(由设备提供)包含供应商清单和 ODM 清单:

  • 供应商清单会指定 SoC 通用的 HAL、VNDK 版本等信息。建议将其放置在 Android 源代码树的 device/${VENDOR}/${DEVICE}/manifest.xml 中,但可以使用多个片段文件。有关详情,请参阅从片段生成设备清单
  • ODM 清单会覆盖供应商清单,并列出产品专用的 HAL。

此设置可让采用相同开发板的多个产品共用同一个供应商映像(用于提供通用 HAL),但具有不同的 ODM 映像(用于指定产品专用的 HAL)。

供应商清单示例:

<?xml version="1.0" encoding="UTF-8"?>
<!-- Comments, Legal notices, etc. here -->
<manifest version="1.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>
        <version>2.0</version>
        <interface>
            <name>INfc</name>
            <instance>default</instance>
        </interface>
    </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="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">
    <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>
    <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>
有关详情,请参阅制定设备清单

框架清单

框架清单文件(由 Google 提供)是手动生成的,位于 Android 源代码树的 /system/libhidl/manifest.xml 中。

框架清单示例:

<?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>

清单文件架构

这一部分介绍了下列 XML 标记的含义。Android 源代码树中的源文件中可以缺少某些“必需”的标记,这些标记可以在编译时由 assemble_vintf 写入。设备上的相应文件中必须有“必需”的标记。

?xml
选用。只向 XML 解析器提供信息。
manifest.version
必需。清单的元版本。描述该清单中应该存在的元素。与 XML 版本无关。
manifest.type
必需。该清单的类型。对于设备清单文件,其值为 device;对于框架清单文件,其值为 framework
manifest.target-level
对于设备清单而言是必需的。用于指定相应设备清单要兼容的框架兼容性矩阵版本(FCM 版本),也称为设备的 Shipping FCM 版本。
manifest.hal
选用且可重复。单个 HAL(HIDL 或本机,如 GL),具体取决于 format 属性。
manifest.hal.format
选用。值可以是以下几项之一:
  • hidl:HIDL HAL。这是默认值。
  • native:本机 HAL。
manifest.hal.override
选用。值可以是以下几项之一:
  • true:覆盖其他具有相同 <name> 和 Major 版本的 <hal> 元素。如果此 <hal> 元素中没有 <version><fqname>,则表示此 HAL 处于停用状态。
  • false:不覆盖其他具有相同 <name> 和 Major 版本的 <hal> 元素。
manifest.hal.name
必需。HAL 的完全限定软件包名称。多个 HAL 条目可以使用相同的名称。示例:
  • android.hardware.camera (HIDL HAL)
  • GLES(本机 HAL,只需要名称)
manifest.hal.transport
manifest.hal.format == "hidl" 时是必需的。在其他情况下,则不得存在。指明从服务管理器查询来自该软件包的接口时将使用什么传输模式。值可以是以下几项之一:
  • hwbinder:绑定模式
  • passthrough:直通模式
manifest.hal.transport.arch
对于 passthrough 是必需的,对于 hwbinder 不得存在。描述正在提供的直通服务的位数。值可以是以下几项之一:
  • 32:32 位模式
  • 64:64 位模式
  • 32+64:两者
manifest.hal.version
选用且可重复。清单中 hal 标记的版本。格式为 MAJOR.MINOR。有关示例,请参阅 hardware/interfacesvendor/${VENDOR}/interfacesframework/hardware/interfaces system/hardware/interfaces

HIDL 和本机 HAL 可以使用多个版本字段,前提是它们代表不同的 Major 版本,并且提供的每个 Major 版本只有一个 Minor 版本。例如,3.1 和 3.2 不能共存,但 1.0 和 3.4 可以共存。这适用于所有同名的 hal 元素,除非 override="true"
manifest.hal.interface
必需,可以在不重名的情况下重复。指明软件包中具有实例名称的接口。一个 <hal> 中可以有多个 <interface> 元素,但名称必须不同。
manifest.hal.interface.name
必需。接口的名称。
manifest.hal.interface.instance
必需且可重复。接口的实例名称。一个接口可以有多个实例,但不能有重复的 <instance> 元素。
manifest.hal.fqname
选用且可重复。为名称是 manifest.hal.name 的 HAL 指定实例的另一种方法。格式为 @MAJOR.MINOR::INTERFACE/INSTANCE。对于从 Android 8.0 升级的设备,它不能用于声明兼容性矩阵所需的实例。
manifest.sepolicy
必需。包含所有与 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 版本。