अतिरिक्त संसाधन

इन संसाधनों में, कोड की जगह, टूल, टेस्टिंग, और लाइसेंसिंग सिस्टम भी उपलब्ध है.

कोड की जगह की जानकारी को क्वेरी किया जा सकता है

क्वेरी किए जा सकने वाले वेंडर इंटरफ़ेस ऑब्जेक्ट का कोड system/libvintf.

हैंडराइटिंग मेनिफ़ेस्ट वाली फ़ाइलें और इनके साथ काम करने वाले मैट्रिक्स का इस्तेमाल करना मुश्किल हो सकता है. इसका इस्तेमाल करें नीचे दिए गए टूल की मदद से, बॉयलरप्लेट मेनिफ़ेस्ट/कंपैटबिलिटी मैट्रिक्स को जनरेट किया जा सकता है से.

शाल

LSHAL, डिवाइस-साइड टूल है जो रजिस्टर किए गए सभी एचएएल को hwservicemanager और सभी उपलब्ध पासथ्रू लागू करना डिवाइस पर (उदाहरण के लिए, android.hardware.foo@1.0-impl.so). यह काम भी कर सकता है सूची के आधार पर एक डिवाइस मेनिफ़ेस्ट फ़ाइल जनरेट करें:

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

यहां दी गई बातों का ध्यान रखें:

  1. अगर पैकेज hwservicemanager पर रजिस्टर है और 'मिल गया' है, तो पासथ्रू एचएएल के तौर पर, <transport> hwbinder.
  2. मेनिफ़ेस्ट में SELinux वर्शन नहीं लिखा गया है. यह सुझाव दिया जाता है कि एलिमेंट को assemble_vintf के ज़रिए इंजेक्ट किया जाता है, जैसा कि नीचे बताया गया है.
  3. जनरेट की गई HAL मेनिफ़ेस्ट फ़ाइल गलत हो सकती है. लोगों का ध्यान खींचना डिवाइस मेनिफ़ेस्ट और फ़ाइल फ़ॉर्मैट के बीच के अंतर को ठीक करना ज़रूरी है vendor.img असल में यह सुविधा देता है.

एएसएसईएमबीएलई_वीआईएनटीएफ़

assemble_vintf एक होस्ट-साइड टूल है, जो:

  1. यह पुष्टि करता है कि कंपैटबिलिटी मैट्रिक्स या मेनिफ़ेस्ट फ़ाइल मान्य है या नहीं.
  2. बिल्ड में उपलब्ध मेनिफ़ेस्ट/कंपैटबिलिटी मैट्रिक्स में वैरिएबल इंजेक्ट करता है समय और एक नई फ़ाइल जनरेट करता है, जिसे डिवाइस पर इंस्टॉल किया जाना चाहिए.
  3. जनरेट की गई फ़ाइल और उसकी दोहरी फ़ाइल के बीच काम करता है या नहीं, इसकी जांच करता है.
  4. अगर मेनिफ़ेस्ट फ़ाइल दी जाती है, तो विकल्प के तौर पर एक बॉयलरप्लेट जनरेट होता है कंपैटबिलिटी मैट्रिक्स, जो मेनिफ़ेस्ट फ़ाइल के साथ काम करता है.

उदाहरण: डिवाइस के साथ काम करने की सुविधा को जनरेट करें मैट्रिक्स को फ़्रेमवर्क मेनिफ़ेस्ट फ़ाइल से लिया गया है

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

ध्यान दें कि सभी एचएएल optional="true" पर सेट हैं.

उदाहरण: स्केलेटन फ़्रेमवर्क के साथ काम करने का तरीका जनरेट करना डिवाइस मेनिफ़ेस्ट फ़ाइल से मैट्रिक्स

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

ध्यान दें कि सभी एचएएल optional="true" पर सेट हैं.

उदाहरण: वैरिएबल से डिवाइस मेनिफ़ेस्ट एक्सएमएल फ़ाइलें जनरेट करें

बिल्ड के समय, अगर नीचे दिए गए वैरिएबल 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

इसके बाद, ये कमांड लागू किए जाते हैं (बिल्ड सिस्टम में, जिन्हें हटाने के लिए बदलाव किया जाता है) विवरण) डिवाइस मेनिफ़ेस्ट एक्सएमएल फ़ाइलें जनरेट करने के लिए करें:

# 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 ऑब्जेक्ट, वेंडर मेनिफ़ेस्ट और ओडीएम मेनिफ़ेस्ट को इस तरह जोड़ता है डिवाइस मेनिफ़ेस्ट को फ़ाइल के तौर पर सेट करें. डिवाइस देखें मेनिफ़ेस्ट में दी गई जानकारी देखें.

उदाहरण: वैरिएबल से, डिवाइस के साथ काम करने वाले मैट्रिक्स एक्सएमएल फ़ाइलें जनरेट करें

बिल्ड के समय, अगर नीचे दिए गए वैरिएबल 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

इसके बाद, ये कमांड लागू किए जाते हैं (बिल्ड सिस्टम में, जिन्हें हटाने के लिए बदलाव किया जाता है) जानकारी) के लिए, नीचे दिया गया तरीका अपनाएं:

# 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 ऑब्जेक्ट वेंडर कंपैटबिलिटी मैट्रिक्स का इस्तेमाल डिवाइस के साथ काम करने वाला मैट्रिक्स. डिवाइस देखें ज़्यादा जानकारी के लिए, कंपैटिबिलिटी मैट्रिक्स देखें.

उदाहरण: वैरिएबल से फ़्रेमवर्क मेनिफ़ेस्ट एक्सएमएल फ़ाइलें जनरेट करें

निम्न वैरिएबल इसमें परिभाषित किए जा सकते हैं 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

नीचे दिए गए निर्देश एक्ज़ीक्यूट किए जाते हैं (बिल्ड सिस्टम में, जिन्हें लागू करने की प्रक्रिया को छोड़ने के लिए उनमें बदलाव किया जाता है) ब्यौरा) मेनिफ़ेस्ट एक्सएमएल फ़ाइलें जनरेट करने के लिए ज़रूरी है:

# 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 ऑब्जेक्ट, सिस्टम मेनिफ़ेस्ट और सिस्टम मेनिफ़ेस्ट को जोड़ता है फ़्रैगमेंट, प्रॉडक्ट मेनिफ़ेस्ट, और प्रॉडक्ट मेनिफ़ेस्ट फ़्रैगमेंट को फ़्रेमवर्क मेनिफ़ेस्ट के तौर पर शामिल करें. यहां जाएं: फ़्रेमवर्क मेनिफ़ेस्ट में दी गई जानकारी देखें.

उदाहरण: वैरिएबल से, फ़्रेमवर्क के साथ काम करने वाले मैट्रिक्स एक्सएमएल फ़ाइलें जनरेट करें

निम्न वैरिएबल इसमें परिभाषित किए जा सकते हैं प्रॉडक्ट FCM तय करने के लिए device/manufacturer/device_name/BoardConfig.mk और किसी खास डिवाइस के लिए 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 को सूंग मॉड्यूल के साथ इंस्टॉल किया जाना चाहिए. प्रॉडक्ट FCM भी इंस्टॉल किया जा सकता है सूंग मॉड्यूल के साथ; DEVICE_PRODUCT_COMPATIBILITY_MATRIX_FILE तय न करें अगर यह का तरीका इस्तेमाल किया जाता है. इसके अलावा, कई प्रॉडक्ट के FCM वर्शन और system_ext FCM वर्शन सूंग मॉड्यूल के साथ इंस्टॉल किया गया. निम्नलिखित को परिभाषित करें:

  • device/manufacturer/device_name/Android.bp में एक मॉड्यूल तय करें. उदाहरण के लिए (बदलें FCM के लिए प्रॉडक्ट के साथ system_ext नियम: 
    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

नीचे दिए गए निर्देश एक्ज़ीक्यूट किए जाते हैं (बिल्ड सिस्टम में, जिन्हें लागू करने की प्रक्रिया को छोड़ने के लिए उनमें बदलाव किया जाता है) जानकारी) के लिए नीचे बताया गया है:

# 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, वेंडर मेनिफ़ेस्ट में आईआर एचएएल को जोड़ देता है, अगर 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) एक्सएमएल में या उससे ऑब्जेक्ट को फ़ेच करता है. बीएसडी जैसा लाइसेंस.
  • पॉलिसीdb पाने के लिए libselinux (external/selinux/libselinux) वर्शन है. सार्वजनिक डोमेन का लाइसेंस.
  • डीकंप्रेस करने के लिए libz (एक्सटर्नल/zlib) /proc/config.gz. बीएसडी जैसा लाइसेंस.
  • libvintf प्रोजेक्ट, Apache 2.0 लाइसेंस का इस्तेमाल करता है (सही के साथ MODULE_ Voice_APACHE2 और नोटिस फ़ाइलें).