추가 리소스

컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

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

쿼리 가능한 코드 위치

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

매니페스트 파일과 호환성 매트릭스를 손으로 쓰는 것은 어려울 수 있습니다. 다음 도구를 사용하여 시작할 상용구 매니페스트/호환성 매트릭스를 생성합니다.

엘샬

LSHAL은 hwservicemanager 에 등록된 모든 HAL과 장치에서 사용 가능한 모든 통과 구현(예: 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 가 실제로 제공하는 것 간의 불일치를 수정하려면 사람의 주의가 필요합니다.

ASEMBLE_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 파일 생성

다음 변수를 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 는 BOARD_ENABLE_IR이 정의된 경우 공급업체 매니페스트에 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 를 사용합니다.

라이선스

  • 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 파일 포함)를 사용합니다.