แหล่งข้อมูลต่อไปนี้ให้รายละเอียดเกี่ยวกับตำแหน่งของโค้ด เครื่องมือ การทดสอบ และการอนุญาตให้ใช้สิทธิ
ตำแหน่งรหัสที่ค้นหาได้
รหัสสำหรับออบเจ็กต์อินเทอร์เฟซผู้ให้บริการที่ค้นหาได้จะส่งไปที่ system/libvintf
เครื่องมือ
การเขียนไฟล์ Manifest และตารางความเข้ากันได้ด้วยตนเองอาจเป็นเรื่องยาก ใช้เครื่องมือต่อไปนี้เพื่อสร้างไฟล์ Manifest/ตารางความเข้ากันได้แบบสำเร็จรูปเพื่อเริ่มต้น
LSHAL
LSHAL เป็นเครื่องมือฝั่งอุปกรณ์ที่แสดงรายการ HAL ที่ลงทะเบียนทั้งหมดเพื่อ hwservicemanager และการใช้งานการส่งผ่านข้อมูลทั้งหมดที่ใช้ได้ (เช่น android.hardware.foo@1.0-impl.so) ในอุปกรณ์ นอกจากนี้ยังสามารถสร้างไฟล์ Device Manifest ตามรายการต่อไปนี้ได้ด้วย
adb shell su 0 /system/bin/lshal --init-vintf
ข้อควรทราบ
- หากแพ็กเกจทั้งจดทะเบียนกับ
hwservicemanagerและพบเป็น HAL แบบส่งผ่าน ระบบจะตั้งค่า<transport>เป็นhwbinder - ไม่มีเวอร์ชัน SELinux ที่เขียนลงในไฟล์ Manifest เราขอแนะนำให้แทรกองค์ประกอบผ่าน
assemble_vintfตามที่อธิบายไว้ด้านล่าง - ไฟล์ Manifest ของ HAL ที่สร้างขึ้นอาจไม่ถูกต้อง ต้องมีการตรวจสอบโดยเจ้าหน้าที่เพื่อแก้ไขความไม่สอดคล้องระหว่างไฟล์ Manifest ของอุปกรณ์กับสิ่งที่
vendor.imgระบุไว้จริง
ASSEMBLE_VINTF
assemble_vintf เป็นเครื่องมือฝั่งโฮสต์ที่ทําสิ่งต่อไปนี้
- ตรวจสอบว่าเมทริกซ์ความเข้ากันได้หรือไฟล์ Manifest ถูกต้อง
- แทรกตัวแปรลงในไฟล์ Manifest/ตารางความเข้ากันได้ที่มีในขณะสร้าง และสร้างไฟล์ใหม่ที่ควรติดตั้งลงในอุปกรณ์
- ตรวจสอบความเข้ากันได้ระหว่างไฟล์ที่สร้างขึ้นกับคู่ของมัน
- หากระบุไฟล์ Manifest ระบบจะสร้างตารางที่ตรงตามรูปแบบทั่วไปซึ่งเข้ากันได้กับไฟล์ Manifest (ไม่บังคับ)
ตัวอย่าง: สร้างตารางความเข้ากันได้ของอุปกรณ์จากไฟล์ Manifest ของเฟรมเวิร์ก
assemble_vintf -m --hals-only \
-i system/libhidl/manifest.xml \
-o device/manufacturer/device_name/compatibility_matrix.xml
โปรดทราบว่า HAL ทั้งหมดตั้งค่าเป็น optional="true"
ตัวอย่าง: สร้างตารางความเข้ากันได้ของเฟรมเวิร์กโครงร่างจากไฟล์ Manifest ของอุปกรณ์
assemble_vintf -m --hals-only \
-i device/foo/bar/manifest.xml \
-o path/to/place/output/compatibility_matrix.xml
โปรดทราบว่า HAL ทั้งหมดตั้งค่าเป็น optional="true"
ตัวอย่าง: สร้างไฟล์ XML ของไฟล์ Manifest ของอุปกรณ์จากตัวแปร
เมื่อมีการสร้าง หากมีการกําหนดตัวแปรต่อไปนี้ใน 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 ของไฟล์ Manifest ของอุปกรณ์
# 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 จะรวมไฟล์ Manifest ของผู้ให้บริการและไฟล์ Manifest ของ ODM เป็นไฟล์ Manifest ของอุปกรณ์ ดูรายละเอียดได้ที่ Device manifest
ตัวอย่าง: สร้างไฟล์ 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 ของไฟล์ Manifest เฟรมเวิร์กจากตัวแปร
ตัวแปรต่อไปนี้อาจกำหนดได้ใน
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 ของไฟล์ Manifest เฟรมเวิร์ก
# 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 จะรวมไฟล์ Manifest ของระบบ ไฟล์ Manifest ของระบบ ไฟล์ Manifest ของผลิตภัณฑ์ และไฟล์ Manifest ของผลิตภัณฑ์ย่อยเป็นไฟล์ Manifest ของเฟรมเวิร์ก ดูรายละเอียดได้ในไฟล์ Manifest ของเฟรมเวิร์ก
ตัวอย่าง: สร้างไฟล์ XML ของตารางการทำงานร่วมกันของเฟรมเวิร์กจากตัวแปร
คุณอาจกำหนดตัวแปรต่อไปนี้ใน device/manufacturer/device_name/BoardConfig.mk เพื่อกำหนด FCM ของผลิตภัณฑ์และ 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
ต้องติดตั้ง FCM ของ system_ext ด้วยโมดูล Soong นอกจากนี้ยังอาจติดตั้ง FCM ของผลิตภัณฑ์ด้วยโมดูล Soong อย่ากำหนด DEVICE_PRODUCT_COMPATIBILITY_MATRIX_FILE หากใช้วิธีนี้ นอกจากนี้ คุณยังติดตั้ง FCM ของผลิตภัณฑ์หลายเวอร์ชันและ FCM ของ system_ext หลายเวอร์ชันได้ด้วยโมดูล Soong
กําหนดค่าต่อไปนี้
-
กำหนดโมดูลใน
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 จะรวมชุดย่อยของเมทริกซ์ความเข้ากันได้ของระบบและเมทริกซ์ความเข้ากันได้ของผลิตภัณฑ์เป็นเมทริกซ์ความเข้ากันได้ของเฟรมเวิร์ก ดูรายละเอียดได้ในตารางความเข้ากันได้ของเฟรมเวิร์ก
ตัวอย่าง: สร้างไฟล์ Manifest ของผู้ให้บริการจากข้อมูลโค้ด
คุณสามารถรวมกลุ่มไฟล์ Manifest ของผู้ให้บริการหลายรายการเข้าด้วยกันได้เมื่อสร้าง เช่น
<!-- 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 ของ IR ลงในไฟล์ Manifest ของผู้ให้บริการหากมีการกําหนด BOARD_ENABLE_IR และจะไม่เพิ่มหากไม่ได้กําหนด BOARD_ENABLE_IR ระบบจะเรียกใช้คําสั่งต่อไปนี้ (แก้ไขเพื่อละเว้นรายละเอียดการติดตั้งใช้งาน) เพื่อสร้างไฟล์ Manifest ของผู้ให้บริการ
# 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 ใบอนุญาตที่คล้ายกับ BSDlibselinux(external/selinux/libselinux) สำหรับรับเวอร์ชัน policydb ใบอนุญาตสาธารณสมบัติlibz(ภายนอก/zlib) สำหรับการขยายไฟล์/proc/config.gzใบอนุญาตที่คล้ายกับ BSD- โปรเจ็กต์
libvintfใช้ใบอนุญาต Apache 2.0 (มีไฟล์ MODULE_LICENSE_APACHE2 และ NOTICE ที่เหมาะสม)