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