Diese Seite wurde von der Cloud Translation API übersetzt.

Zusätzliche Ressourcen

Die folgenden Ressourcen enthalten Details zu Speicherorten, Tools, Tests, und Lizenzierung.

Speicherort des Abfragecodes

Der Code für das abfragbare Benutzeroberflächenobjekt des Anbieters system/libvintf

Handschrift-Manifestdateien und Kompatibilitätsmatrizen können schwierig sein. Verwenden Sie die Methode folgenden Tools zum Generieren einer Boilerplate-Manifest-/Kompatibilitätsmatrix aus.

Lshal

LSHAL ist ein geräteseitiges Tool, das alle registrierten HALs hwservicemanager und alle verfügbaren Passthrough-Implementierungen (z.B. android.hardware.foo@1.0-impl.so) auf dem Gerät. Es kann auch Generieren Sie basierend auf der Liste eine Gerätemanifestdatei:

adb shell su 0 /system/bin/lshal --init-vintf

Beachten Sie Folgendes:

Wenn ein Paket sowohl bei hwservicemanager registriert als auch gefunden wurde als Passthrough-HAL ist <transport> auf hwbinder
In das Manifest ist keine SELinux-Version geschrieben. Es wird empfohlen, -Element wird wie unten erläutert über assemble_vintf eingeschleust.
Die generierte HAL-Manifestdatei ist möglicherweise ungenau. Die menschliche Aufmerksamkeit erforderlich, um Inkonsistenzen zwischen dem Gerätemanifest und dem vendor.img tatsächlich bereitstellt.

ASSEMBLE_VINTF

assemble_vintf ist ein hostseitiges Tool, das:

Überprüft, ob eine Kompatibilitätsmatrix oder Manifestdatei gültig ist.
Injiziert Variablen in Manifeste/Kompatibilitätsmatrixen, die im Build verfügbar sind und erstellt eine neue Datei, die auf dem Gerät installiert werden sollte.
Prüft die Kompatibilität zwischen der generierten Datei und ihrem Dual-Format.
Wenn eine Manifestdatei angegeben wurde, wird optional ein Standardcode generiert. Kompatibilitätsmatrix, die mit der Manifestdatei kompatibel ist.

Beispiel:Gerätekompatibilität generieren Matrix aus einer Framework-Manifestdatei

assemble_vintf -m --hals-only \
    -i system/libhidl/manifest.xml \
    -o device/manufacturer/device_name/compatibility_matrix.xml

Beachten Sie, dass alle HALs auf optional="true" gesetzt sind.

Beispiel:Skeleton-Framework-Kompatibilität generieren Matrix aus einer Gerätemanifestdatei

assemble_vintf -m --hals-only \
    -i device/foo/bar/manifest.xml \
    -o path/to/place/output/compatibility_matrix.xml

Beachten Sie, dass alle HALs auf optional="true" gesetzt sind.

Beispiel:Manifest-XML-Dateien des Geräts aus Variablen generieren

Wenn bei der Build-Erstellung die folgenden Variablen definiert in 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

Dann werden die folgenden Befehle ausgeführt (im Build-System geändert, um die Implementierung Details) aus, um Manifest-XML-Dateien für Geräte zu generieren:

# 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

Zur Laufzeit kombiniert das VINTF-Objekt Anbietermanifeste und ODM-Manifeste als Gerätemanifest. Siehe Gerät .

Beispiel:XML-Dateien mit einer Gerätekompatibilitätsmatrix aus Variablen generieren

Wenn bei der Build-Erstellung die folgenden Variablen definiert in 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

Dann werden die folgenden Befehle ausgeführt (im Build-System geändert, um die Implementierung Details), um XML-Dateien mit der Gerätekompatibilitätsmatrix zu generieren:

# 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

Zur Laufzeit verwendet das VINTF-Objekt die Anbieterkompatibilitätsmatrix als Gerätekompatibilitätsmatrix ermittelt. Siehe Gerät finden Sie weitere Informationen.

Beispiel:Framework-Manifest-XML-Dateien aus Variablen generieren

Folgende Variablen können in 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

Die folgenden Befehle werden ausgeführt (im Build-System, geändert, um die Implementierung Details), um Framework-Manifest-XML-Dateien zu generieren:

# 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

Zur Laufzeit kombiniert das VINTF-Objekt das Systemmanifest, das Systemmanifest Fragmente, Produktmanifest und Produktmanifestfragmente als Framework-Manifest. Weitere Informationen finden Sie unter Framework .

Beispiel:XML-Dateien mit Framework-Kompatibilitätsmatrix aus Variablen generieren

Folgende Variablen können in device/manufacturer/device_name/BoardConfig.mk zum Definieren des FCM-Produkts und gerätespezifisches System-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

Die FCM-Datei system_ext muss mit Soong-Modulen installiert werden. Möglicherweise ist auch das Produkt FCM installiert. mit Soong-Modulen. DEVICE_PRODUCT_COMPATIBILITY_MATRIX_FILE nicht definieren, wenn verwendet wird. Außerdem können mehrere FCM-Versionen des Produkts und system_ext FCM-Versionen mit Soong-Modulen installiert. Legen Sie Folgendes fest:

Definieren Sie ein Modul in device/manufacturer/device_name/Android.bp. Beispiel: (Ersetzen system_ext mit Produkt für Produkt 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",
    ],
}

Installiere das Modul auf device/manufacturer/device_name/device.mk. Hier einige Beispiele:
```
PRODUCT_PACKAGES += system_ext_compatibility_matrix.xml
```

Die folgenden Befehle werden ausgeführt (im Build-System, geändert, um die Implementierung Details), um XML-Dateien mit der Framework-Kompatibilitätsmatrix zu generieren:

# 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

Zur Laufzeit kombiniert das VINTF-Objekt einen Teil der Systemkompatibilität und Produktkompatibilitätsmatrizes als Framework-Kompatibilität Matrixstruktur. Weitere Informationen finden Sie unter Framework finden Sie weitere Informationen.

Beispiel: Anbietermanifest aus Fragmenten generieren

Mehrere Anbietermanifestfragmente können bei der Erstellung gebündelt werden. Beispiel:

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

Dann fügt assemble_vintf den IR HAL dem Anbietermanifest hinzu, wenn BOARD_ENABLE_IR ist definiert und lässt ihn aus, wenn BOARD_ENABLE_IR ist nicht definiert. Mit den folgenden Befehlen (geändert, um Implementierungsdetails auszulassen) werden ausgeführt, um das Anbietermanifest zu generieren:

# 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

Weitere Informationen erhalten Sie hier:

assemble_vintf --help

Testen

Das Projekt platform/system/libvintf verwendet GTest für Serialisierung, Deserialisierung und Kompatibilitätsprüfung.

Lizenzierung

tinyxml2 (external/tinyxml2) zum Serialisieren/Deserialisieren des in XML umwandeln. BSD-ähnliche Lizenz.
libselinux (external/selinux/libselinux) zum Abrufen von policydb Version. Urheberrechtsfreie Inhalte („Public Domain“).
libz (external/zlib) für die Dekomprimierung /proc/config.gz. BSD-ähnliche Lizenz.
libvintf-Projekt eine Apache 2.0-Lizenz (mit entsprechenden MODULE_LIZENZ-APACHE2- und NOTICE-Dateien).