1. 课程导入

Android GKI（Generic Kernel Image，通用内核镜像）是 Android 内核从“每设备定制”走向“统一内核 + 可插拔模块”的关键转折。它并不是一次简单的内核版本升级，而是把内核核心与厂商实现解耦：Google 提供统一的 GKI 内核镜像与稳定 KMI（Kernel Module Interface），芯片厂商与 OEM 通过 GKI 之外的 vendor 模块、设备树、驱动模块来承载差异化能力。理解这一演进逻辑，是后续版本迁移与兼容调试的起点。

一、演进背景：为什么必须走向 GKI

在 GKI 之前，Android 设备的内核由 SoC 厂商基于某个 LTS 版本深度定制，OEM 再叠加自己的驱动与补丁。结果是：同一 Android 版本下，内核分支碎片化严重，安全补丁难以统一下发，Android 平台升级往往被内核升级“卡住”。Google 从 Android 11 起推动 GKI，并在 Android 12/13 逐步强制：内核核心由 Google 统一构建，厂商能力以模块形式加载。

GKI 的核心约束可以概括为三点：

• 内核核心统一：Google 维护 GKI 内核镜像，包含调度、内存、电源、安全等核心子系统。
• KMI 稳定：内核与模块之间通过稳定符号接口交互，KMI 一旦冻结，模块可在不同 GKI 版本间复用。
• 模块化承载差异：SoC 与 OEM 的驱动、设备树、vendor hook 以模块或 vendor 分区形式存在，不再直接修改内核核心。

二、学习目标：学完本课程你能做什么

本课程面向已经具备 Linux 内核基础、参与过 Android 系统或驱动开发的工程师。完成学习后，你应当能够：

1. 说清 GKI 的版本命名、KMI 冻结机制与 ABI 监控方式，判断一次迁移的影响范围。
2. 独立完成从旧内核到 GKI 内核的迁移评估，识别 vendor hook、私有符号、设备树与模块依赖的风险点。
3. 使用 ABI 比对、符号检查、模块加载日志等工具定位兼容性问题，并给出修复方案。
4. 掌握 GKI 兼容调试的常见排障路径，包括模块加载失败、符号缺失、KMI 断裂、启动阶段异常等。
5. 建立可复用的迁移检查清单与回归验证流程，降低后续版本升级成本。

三、课程整体框架：从认知到实战

课程共 30 章，按“认知—迁移—调试—复盘”四段推进。前段建立 GKI 版本、KMI、ABI 的概念模型；中段进入迁移实操，覆盖内核配置、模块拆分、设备树适配、vendor hook 替换；后段聚焦兼容调试与排障，最后以综合案例与复盘收束。

四、迁移调试全景图

下面这张图把 GKI 迁移调试的全景压缩为一条主线：从旧内核出发，经过评估、迁移、构建、验证，最终进入兼容调试闭环。图中同时标出了各阶段最常用的工具与判断点，便于你在后续章节中快速定位。

五、典型场景与常见误区

一个典型迁移场景是：某 OEM 在旧内核中直接修改了 drivers/mmc 下的核心代码，并依赖若干未导出的私有符号。迁移到 GKI 后，这些修改无法进入内核核心，私有符号也不在 KMI 白名单中，导致模块加载失败。正确做法是把差异下沉为 vendor 模块，或改用 GKI 提供的稳定接口与 vendor hook。

# 典型模块加载失败日志
[   12.345678] my_vendor_drv: loading out-of-tree module taints kernel
[   12.345701] my_vendor_drv: Unknown symbol mmc_private_helper (err -2)
[   12.345720] my_vendor_drv: module verification failed: signature and/or required key missing
[   12.345733] my_vendor_drv: probe of my_vendor_drv failed with error -2