AVB 속성의 버전 정보

Keymaster 버전 지원 바인딩 기기 부트로더가 운영체제 (OS) 버전을 제공해야 합니다. 각 파티션의 보안 패치 수준을 지정합니다 OS 버전과 보안 패치 수준은 AVB의 두 개의 개별 키-값 쌍 속성을 참조하세요. 예를 들면 다음과 같습니다.

  • com.android.build.system.os_version -> '12'
  • com.android.build.system.security_patch -> '2022-02-05'
  • com.android.build.vendor.os_version -> '12'
  • com.android.build.vendor.security_patch -> '2022-02-05'
  • com.android.build.boot.os_version -> '12'
  • com.android.build.boot.security_patch -> '2022-02-05'

기기 부트로더는 avb_property_lookup() 여러 vbmeta 이미지는 avb_slot_verify() 포드는 AvbSlotVerifyData** out_data output 매개변수로 전달됩니다.

버전 정보의 기본 형식

기본적으로 Android 빌드 시스템은 OS에 다음 형식을 사용합니다. 버전 및 보안 패치를 각각 업데이트합니다.

com.android.build.${partition}.os_version의 형식은 A[.B.C]입니다(예: 12 또는 12.0.0).

  • A: 메이저 버전
  • B: 마이너 버전(없으면 0으로 설정됨)
  • C: 하위 마이너 버전(없으면 0으로 설정됨)

com.android.build.${partition}.security_patch의 형식은 YYYY-MM-DD입니다.

기본적으로 빌드 시스템은 system, system_ext, product 파티션용 com.android.build.${partition}.security_patch를 생성합니다. 시스템 파티션이 아닌 파티션에는 기기 제조업체가 BOOT_SECURITY_PATCH, VENDOR_SECURITY_PATCH, 기타 패치를 설정해야 합니다. 예를 들면 다음과 같습니다.

  • BOOT_SECURITY_PATCH := 2022-01-05는 다음을 생성합니다.
    • com.android.build.boot.security_patch -> '2022-01-05'
  • VENDOR_SECURITY_PATCH := 2022-02-05는 다음을 생성합니다.
    • com.android.build.vendor.security_patch -> '2022-02-05'

기기 제조업체는 *_SECURITY_PATCH를 다음과 같이 설정할 수 있습니다. $(PLATFORM_SECURITY_PATCH) 모든 파티션을 항상 동일한 보안이 적용된 버전으로 업데이트하는 경우 패치 수준입니다.

  • BOOT_SECURITY_PATCH := $(PLATFORM_SECURITY_PATCH)
  • VENDOR_SECURITY_PATCH := $(PLATFORM_SECURITY_PATCH)

맞춤 버전 정보 지정

Android 13부터 각 기기 빌드는 기기 부트로더가 인식할 수 있는 OS 버전의 맞춤 값을 가질 수 있습니다. 예를 들면 다음과 같습니다.

  • SYSTEM_OS_VERSION := 12.0.0는 다음을 생성합니다.
    • com.android.build.system.os_version -> '12.0.0'
  • BOOT_OS_VERSION := a.b.c는 다음을 생성합니다.
    • com.android.build.boot.os_version -> 'a.b.c'
  • VENDOR_OS_VERSION := 12.0.1은 다음을 생성합니다.
    • com.android.build.vendor.os_version -> '12.0.1'

부팅 이미지 헤더에서 더 이상 사용하지 않는 버전 정보

Keymaster는 Android 9부터 버전 결합 boot.img 헤더에서 os_version 삭제를 제안합니다.

여기에서는 비교해 볼 수 있도록 더 이상 사용하지 않는 부팅 이미지 헤더의 버전 정보 사용법도 설명합니다. 부팅 헤더의 os_version 필드는 OS 버전과 보안 패치 수준을 모두 부호 없는 32비트 정수 형태로 결합합니다. 또한, 이 메커니즘은 모든 이미지가 함께 업데이트된다고 가정하며 프로젝트 Treble에서 파티션이 모듈화된 후에는 사용되지 않습니다.

// Operating system version and security patch level.
// For version "A.B.C" and patch level "Y-M-D":
//   (7 bits for each of A, B, C; 7 bits for (Y-2000), 4 bits for M)
//   A = os_version[31:25]
//   B = os_version[24:18]
//   C = os_version[17:11]
//   Y = 2000 + os_version[10:4]
//   M = os-version[3:0]

uint32_t os_version;