추가 리소스

다음 리소스는 코드 위치, 도구, 테스트 및 라이선스에 관한 세부정보를 제공합니다.

쿼리 가능한 코드 위치

쿼리 가능한 공급업체 인터페이스 객체의 코드는 system/libvintf로 이동합니다.

매니페스트 파일과 호환성 매트릭스를 손수 작성하기란 쉽지 않을 수 있습니다. 다음 도구를 사용하면 시작점으로 활용할 수 있는 상용구 매니페스트/호환성 매트릭스를 생성할 수 있습니다.

LSHAL

LSHAL은 모든 등록된 HAL을 hwservicemanager에 나열하고 모든 가용한 패스 스루 구현(예: android.hardware.foo@1.0-impl.so)을 기기에 나열하는 기기 측 도구입니다. 목록을 기준으로 기기 매니페스트 파일을 생성할 수도 있습니다.

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

다음 내용을 참고하세요.

  1. 두 패키지가 모두 hwservicemanager로 등록되었고 패스 스루 HAL로 발견된 경우 <transport>hwbinder로 설정됩니다.
  2. 매니페스트에는 SELinux 버전이 작성되지 않습니다. 요소는 아래의 설명처럼 assemble_vintf를 통해 삽입되는 것이 좋습니다.
  3. 생성된 HAL 매니페스트 파일은 정확하지 않을 수 있습니다. 기기 매니페스트, 그리고 vendor.img에서 실제로 제공하는 콘텐츠 간의 비일관성을 해결하려면 사람이 직접 살펴봐야 합니다.

ASSEMBLE_VINTF

assemble_vintf는 다음을 실행하는 호스트 측 도구입니다.

  1. 호환성 매트릭스 또는 매니페스트 파일이 유효한지 확인합니다.
  2. 변수를 빌드 시간에 사용 가능한 매니페스트/호환성 매트릭스로 삽입하고 기기에 설치되어야 하는 새 파일을 생성합니다.
  3. 생성된 파일과 복제본 간의 호환성을 확인합니다.
  4. 매니페스트 파일이 주어지면 매니페스트 파일과 호환되는 상용구 호환성 매트릭스를 선택적으로 생성합니다.

예: 프레임워크 매니페스트 파일에서 기기 호환성 매트릭스를 생성

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 객체가 시스템 매니페스트, 시스템 매니페스트 프래그먼트, 제품 매니페스트 및 제품 매니페스트 프래그먼트를 프레임워크 매니페스트로 결합합니다. 자세한 내용은 프레임워크 매니페스트를 참고하세요.

예: 변수에서 프레임워크 호환성 매트릭스 XML 파일을 생성

제품 FCM 및 기기별 시스템 FCM을 정의하기 위해 device/manufacturer/device_name/BoardConfig.mk에 다음 변수를 정의할 수 있습니다.

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

Soong 모듈과 함께 system_ext FCM을 설치해야 합니다. Soong 모듈과 함께 제품 FCM을 설치할 수 있습니다. 이 방법을 사용하는 경우 DEVICE_PRODUCT_COMPATIBILITY_MATRIX_FILE를 정의하지 마세요. 또한 Soong 모듈과 함께 여러 제품 FCM 버전과 system_ext FCM 버전을 설치할 수도 있습니다. 다음을 정의합니다.

  • 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

그런 다음 BOARD_ENABLE_IR가 정의된 경우 assemble_vintf가 IR HAL을 공급업체 매니페스트에 추가하며, 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를 사용합니다.

라이선스

  • 객체 및 XML 간 직렬화/역직렬화를 위한 tinyxml2(external/tinyxml2), BSD와 흡사한 라이선스
  • policydb 버전을 가져오기 위한 libselinux(external/selinux/libselinux), 공개 도메인 라이선스
  • /proc/config.gz의 압축 해제를 위한 libz(external/zlib), BSD와 흡사한 라이선스
  • libvintf 프로젝트는 Apache 2.0 라이선스(적절한 MODULE_LICENSE_APACHE2 및 NOTICE 파일 포함)를 사용함