本頁介紹如何將新核心功能配置為 GKI 模組或將現有內建核心功能配置為 GKI 模組。
將新功能配置為 GKI 模組
對於新功能,編輯
gki_defconfig
並將所需核心功能的配置項目從n
設為m
(=m
)。在arch/arm64/configs/gki_defconfig
和arch/x86/configs/gki_defconfig
中設定此設定。將針對此功能產生的 KO (
.ko
) 檔案新增至common/modules.bzl
的COMMON_GKI_MODULES_LIST
部分。按排序順序新增檔案。如果您不確定生成的所有文件,構建將失敗並列出要添加到列表中的所有必需的 KO 文件。將步驟 2 中的同一組 KO 檔案(按運行時二進位搜尋的升序排序)新增至
common/android/gki_{ARCH}_protected_modules
中,以將該模組指定為受保護的 GKI 模組。使用tools/bazel run //common:kernel_aarch64_abi_update_protected_exports
foraarch64
更新受保護的導出列表,以包含common/android/abi_gki_protected_exports_{ARCH}
中新添加的模組中的導出列表。指定為受保護 GKI 模組的模組仍必須經過 Google 批准才能成為官方受保護模組。確保將步驟 2 中新新增的 KO 檔案複製到核心的
out/<androidX-YZ>/dist/system_dlkm.img
和out/ androidX-YZ /dist/system_dlkm_staging_archive.tar.gz
。system_dlkm_staging_archive.tar.gz
存檔中的模組可用作平台建置中產生system_dlkm.img
輸入。提交您的更改以供審核。 GKI 模組是 Android 獨有的核心功能,因此不需要向上游提交模組轉換補丁。但是,您必須遵循其他準則來提交Android 通用核心 (ACK) 補丁。
將核心內建功能配置為 GKI 模組
對於現有的內建核心功能,請編輯
gki_defconfig
並將所需核心功能的配置項目從y
設定為m
(=m
)。在arch/arm64/configs/gki_defconfig
和arch/x86/configs/gki_defconfig
中設定此設定。將針對此功能產生的 KO (
.ko
) 檔案新增至common/modules.bzl
的COMMON_GKI_MODULES_LIST
部分。按排序順序新增檔案。如果您不確定生成的所有文件,構建將失敗並列出要添加到列表中的所有必需的 KO 文件。將步驟 2 中的同一組 KO 檔案(按運行時二進位搜尋的升序排序)新增至
common/android/gki_{ARCH}_protected_modules
中,以將該模組指定為受保護的 GKI 模組。使用tools/bazel run //common:kernel_aarch64_abi_update_protected_exports
foraarch64
更新受保護的導出列表,以包含common/android/abi_gki_protected_exports_{ARCH}
中新添加的模組中的導出列表。指定為受保護 GKI 模組的模組仍必須經過 Google 批准才能成為官方受保護模組。確保將步驟 2 中新轉換的模組 KO 檔案複製到核心的
out/<androidX-YZ>/dist/system_dlkm.img
和out/ androidX-YZ /dist/system_dlkm_staging_archive.tar.gz
。system_dlkm_staging_archive.tar.gz
存檔中的模組可用作平台建置中產生system_dlkm.img
輸入。提交您的更改以供審核。 GKI 模組是 Android 獨有的核心功能,因此不需要向上游提交模組轉換補丁。但是,您必須遵循其他準則來提交Android 通用核心 (ACK) 補丁。
將受保護的 GKI 模組轉換為不受保護的
從
common/android/gki_protected_modules
的受保護模組清單中刪除從受保護轉換為不受保護的模組。使用
tools/bazel run //common:kernel_aarch64_abi_update_protected_exports
foraarch64
更新受保護的導出列表,以排除common/android/abi_gki_protected_exports_{ARCH}
中新轉換的不受保護模組中的導出列表。提交您的更改以供審核。 GKI 模組是 Android 獨有的核心功能,因此不需要向上游提交模組轉換補丁。但是,您必須遵循其他準則來提交Android 通用核心 (ACK) 補丁。
GKI 模組符號違規解決快速指南
當未簽署的模組違反 GKI 模組的符號保護時,模組載入期間可能會遇到兩種類型的錯誤,導致失敗。
1. 使用受保護符號的無符號模組
錯誤:
module: Protected symbol: some_kernel_function (err -13)
原因:
module.ko
檔案是未簽署的供應商模組,在載入期間嘗試解析 GKI 模組匯出的符號some_kernel_function
,但未列在供應商符號清單中。
解決:
如果module.ko
不是受保護的 GKI 模組,則更新符號清單將透過在供應商符號清單中包含some_kernel_function
來解決該錯誤。或者,使用module.ko
的 GKI 版本。
2. 未簽名模組導出受保護的符號
錯誤:
module: exports protected symbol some_kernel_function
原因:
導出some_kernel_function
模組是受保護的 GKI 模組,而module.ko
可能是該模組的未簽章自訂版本。當module.ko
嘗試匯出some_kernel_function
(只能由簽署的 GKI 模組匯出)時,載入失敗並顯示此訊息。
解決:
如果未簽署的模組是自訂版本,則可以透過使用匯出some_kernel_function
的模組的 GKI 版本來修正此問題。