實作 GKI 模組區段

由於 GKI 模組位於名為 system_dlkm 的超級圖像中，因此 GKI 和 GKI 模組可獨立更新，不受其他分區影響。Google 會使用核心建構時金鑰組簽署 GKI 模組，且這些模組僅與用於建構的 GKI 相容。GKI 和 GKI 模組沒有 ABI 穩定性。以便載入模組 請務必在執行階段中正確建構及更新 GKI 和 GKI 模組 。

實作 system_dklm 分區支援

system_dlkm 分區位於超分區中，做為另一個動態值 這個分區可包含：

  • Google 建構期間已簽署的核心模組
  • depmod 個成果

建立 system_dlkm

建立 system_dlkm 的程序與建立其他動態區隔的程序類似。請按照下列步驟將 system_dlkm 新增至建構作業：

  1. 在 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

  2. 在分區清單中新增 system_dlkm： BOARD_GOOGLE_SYSTEM_DYNAMIC_PARTITIONS_PARTITION_LIST := system_dlkm

  3. (選用) 如果是 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 代表跨區隔依附元件，因此載入供應商模組時，系統會自動載入任何必要的 GKI 模組。

舉例來說，如要從預先建構項目為 GKI arm64 核心 5.15 安裝所有 GKI 模組，請在 system_dlkm 分割區上執行以下命令：

 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 的檔案內容。如要在 system_dlkm 分割區中載入 GKI 模組檔案，負責載入模組的供應商程序需要在供應商網域中提供 sepolicy。

舉例來說，Cuttlefish 用來載入 GKI 模組的 dlkm_loader，在 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