GKI и модули GKI можно обновлять независимо от остального раздела, поскольку модули GKI находятся в отдельном динамическом разделе суперобраза с именем system_dlkm . Модули GKI подписываются Google с помощью пары ключей сборки ядра и совместимы только с тем GKI, с помощью которого они собраны. Между модулями GKI и GKI отсутствует стабильность ABI; для корректной загрузки модулей во время выполнения модули GKI и GKI должны собираться и обновляться одновременно.
Реализовать поддержку раздела system_dklm
Раздел system_dlkm расположен в суперразделе как ещё один динамический раздел. Этот раздел может содержать:
- Модули ядра, подписанные во время сборки Google
- артефакты
depmod
Сборка system_dlkm
Сборка system_dlkm аналогична сборке других динамических разделов. Чтобы добавить system_dlkm в сборку, выполните следующие действия:
В
BoardConfig.mkдобавьте следующие записи:BOARD_USES_SYSTEM_DLKMIMAGE := true BOARD_SYSTEM_DLKMIMAGE_FILE_SYSTEM_TYPE := $(TARGET_RO_FILE_SYSTEM_TYPE) TARGET_COPY_OUT_SYSTEM_DLKM := system_dlkmВ списке разделов добавьте
system_dlkm:BOARD_GOOGLE_SYSTEM_DYNAMIC_PARTITIONS_PARTITION_LIST := system_dlkm(Необязательно) Для устройств A/B и виртуальных устройств A/B добавьте следующую строку в файл
device.mkдля вашего устройства:AB_OTA_PARTITIONS += system_dlkm
Определите модули ядра для копирования в system_dlkm
Для успешной загрузки модулей во время выполнения GKI и модули GKI должны быть собраны вместе. Поэтому необходимо определить модули ядра в сборке GKI для целевой архитектуры и указать их в качестве исходных для раздела system_dlkm во время сборки платформы.
Для Android 13
Укажите BOARD_SYSTEM_DLKM_SRC папку, содержащую необходимые объектные файлы ядра модулей GKI для устройства, в качестве входных данных для системы сборки для создания раздела system_dlkm . Например:
Укажите исходный код модулей GKI в папке и укажите путь к этой папке в BOARD_SYSTEM_DLKM_SRC . Например:
BOARD_SYSTEM_DLKM_SRC := kernel/prebuilts/5.10/arm64/system_dlkm_staging
Во время сборки модули, перечисленные в BOARD_SYSTEM_DLKM_SRC , устанавливаются в $ANDROID_PRODUCT_OUT/system_dlkm .
Для Android 14
Мы оптимизировали реализацию, используя макросы ( BOARD_*_KERNEL_MODULES ) для других разделов *_dlkm . Список необходимых модулей GKI для устройства должен ссылаться на макрос BOARD_SYSTEM_KERNEL_MODULES . Во время сборки эти модули устанавливаются в $ANDROID_PRODUCT_OUT/system_dlkm . Любой модуль в разделе vendor_dlkm , имеющий зависимости от модулей в разделе system_dlkm , генерирует корректные ссылки в файле modules.dep для раздела vendor_dlkm . Благодаря межраздельным зависимостям, представленным в modules.dep , при загрузке модуля vendor автоматически загружаются все необходимые модули GKI.
Например, чтобы установить все модули GKI в раздел system_dlkm для ядра GKI arm64 5.15 из готовых пакетов:
BOARD_SYSTEM_KERNEL_MODULES := $(wildcard kernel/prebuilts/5.15/arm64/*.ko)
Монтировать system_dlkm во время выполнения
В зависимости от того, какая файловая система используется только для чтения, добавьте в fstab следующее, чтобы смонтировать раздел system_dlkm во время выполнения:
ext4 как файловая система только для чтения
system_dlkm /system_dlkm ext4 noatime,ro,errors=panic wait,logical,first_stage_mount,slotselect,avb
erofs как файловая система только для чтения
system_dlkm /system_dlkm erofs ro wait,logical,first_stage_mount,slotselect,avb
Монтаж перегородок и загрузка модулей
На first_stage_init раздел system_dlkm монтируется в файловую систему /system_dlkm в режиме «только чтение». При успешном монтировании становятся доступны символические ссылки в каталоге /system/lib/modules указывающие на /system_dlkm/lib/modules .
Процесс поставщика, например, скрипт .rc , может затем загрузить модули ядра в порядке, указанном в modules.load . Процесс поставщика должен использовать символическую ссылку /system/lib/modules для загрузки модулей. При необходимости процесс поставщика может также загрузить модули позднее.
SELinux
Каждый файл в разделе system_dlkm помечен файловым контекстом system_dlkm_file . Для загрузки файла модулей GKI в раздел system_dlkm процессу поставщика, отвечающему за загрузку модулей, необходима sepolicy в домене поставщика.
Например, dlkm_loader , используемый Cuttlefish для загрузки модулей GKI, имеет следующие разрешения в файле политики в shared/sepolicy/vendor/dlkm_loader.te :
allow dlkm_loader self:capability sys_module;
allow dlkm_loader system_dlkm_file:dir r_dir_perms;
allow dlkm_loader system_dlkm_file:file r_file_perms;
allow dlkm_loader system_dlkm_file:system module_load;
Проверьте раздел system-dlkm
Google предоставляет тестовый пример GKI VTS для проверки раздела system_dlkm . Чтобы вручную запустить тест, используйте следующую команду atest :
atest -c vts_dlkm_partition_test