Для поддержки привязки версии 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()
. Несколько изображений vbmeta могут быть загружены с помощью avb_slot_verify()
и будут сохранены в выходном параметре AvbSlotVerifyData**
out_data
.
Формат информации о версии по умолчанию
По умолчанию система сборки Android будет использовать следующий формат для версии ОС и исправления безопасности соответственно.
Формат com.android.build.${partition}.os_version
— A[.BC], например, «12» или «12.0.0»:
- A: основная версия
- 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
генерирует-
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 9, привязка версии Keymaster предлагает удалить 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;