Информация о версии в свойствах AVB

Для поддержки привязки версии KeyMint (ранее Keymaster) загрузчик устройства должен предоставлять версию операционной системы (ОС) и уровень исправлений безопасности для каждого раздела. Версия ОС и уровень исправлений безопасности представляют собой две отдельные пары ключ-значение в свойствах 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 из образа vbmeta, используя avb_property_lookup() . Функция avb_slot_verify() может загрузить несколько образов vbmeta, которые сохраняются в выходном параметре out_data AvbSlotVerifyData** .

Формат информации о версии по умолчанию

По умолчанию система сборки Android использует следующий формат для версии ОС и патча безопасности соответственно.

Формат файла com.android.build.${partition}.os_version — A[.BC], например, 12 или 12.0.0 :

  • А: основная версия
  • B: дополнительная версия, по умолчанию равна нулю, если отсутствует.
  • C: суб-минорная версия, по умолчанию равна нулю, если она отсутствует.

Формат файла com.android.build.${partition}.security_patch — ГГГГ-ММ-ДД.

По умолчанию система сборки генерирует com.android.build.${partition}.security_patch для разделов system , system_ext и product . Производитель устройства должен установить BOOT_SECURITY_PATCH , VENDOR_SECURITY_PATCH и другие патчи для разделов, не относящихся к системе. Например:

  • BOOT_SECURITY_PATCH := 2022-01-05 generates
    • com.android.build.boot.security_patch -> '2022-01-05'
  • VENDOR_SECURITY_PATCH := 2022-02-05 generates
    • 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, каждая сборка устройства может иметь пользовательское значение для версии ОС, которое распознается загрузчиком устройства. Например:

  • SYSTEM_OS_VERSION := 12.0.0 генерирует
    • com.android.build.system.os_version -> '12.0.0'
  • BOOT_OS_VERSION := abc generates
    • com.android.build.boot.os_version -> 'abc'
  • VENDOR_OS_VERSION := 12.0.1 генерирует
    • com.android.build.vendor.os_version -> '12.0.1'

Устаревшая информация о версии в заголовке образа загрузки.

В Android 9 и более поздних версиях привязка версии в Keymaster 4 предлагает удалить os_version из заголовка boot.img .

Для сравнения здесь также описан устаревший способ получения информации о версии из заголовка загрузочного образа. Обратите внимание, что поле os_version в заголовке загрузочного образа объединяет версию ОС и уровень исправлений безопасности в 32-битное беззнаковое целое число. И этот механизм предполагает, что все образы будут обновляться одновременно, что устарело после модульной организации разделов в Project 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;