本文介绍了通用内核映像 (GKI) 的版本控制方案。通用内核映像 (GKI) 具有一个称为内核版本的唯一标识符。内核版本由内核模块接口 (KMI) 版本和子级组成。内核版本特定于所发布的映像,而 KMI 版本表示构建版本所基于的接口。KMI 版本可以支持多个内核版本。 一个内核版本仅与一个 KMI 版本相关联。在极少数情况下,假如必须更改内核模块接口,KMI 代系会进行迭代,以反映 KMI 版本中的更改。
术语总结
下表总结了本文以及 GKI 更新中使用的重要术语。
名称 | 符号 | 示例 | 说明 |
---|---|---|---|
内核版本 | w.x.y-zzz-k-suffix | 5.4.42-android12-0-foo | GKI 版本的唯一标识符。这是由 uname 返回的值。 |
KMI 版本 | w.x-zzz-k | 5.4-android12-0 | 用于描述 GKI 和可动态加载的内核模块 (DLKM) 之间的内核模块接口 (KMI)。 |
子级 | y | 42 | 用于描述同一 KMI 版本中内核版本的发布顺序。 |
下表列出了其他相关术语,供您参考。
名称 | 符号 | 示例 | 说明 |
---|---|---|---|
w.x.y | w.x.y | 5.4.42 |
如需了解详情,请参阅 Linux 内核 Makefile(搜索“KERNELRELEASE”)。 本文档中使用了“w.x.y”。此名称通常也称为“三段式版本号”。VINTF 中所用的术语“内核版本”可能会与其他术语(尤其是“w”)相混淆。 此变量在 libkver 中称为“kernel_version_tuple”。kernel_version_tuple 不得通过任何更新(包括 OTA 或 Mainline)减小此元组。 |
内核分支 | zzz-w.x | android12-5.4 | 这一术语在通用内核分支类型中使用。 |
版本 | w | 5 | 本文档中未使用此术语。此变量在 libkver 中称为“version”。 |
补丁程序级别 | x | 4 | 本文档中未使用此术语。此变量在 libkver 中称为“patch_level”。 |
Android 版本 | zzz | android12 |
这是与内核关联的 Android(dessert)版本号。
比较 不得通过任何更新(包括 OTA 或 Mainline)减小 Android 版本号。 |
KMI 代系 | k | 0 |
这是为处理不太可能发生的事件而增加的额外编号。如果某个安全 bug 修复程序需要对同一 Android 版本中的 KMI 进行更改,系统会提高 KMI 代系。 KMI 代系编号以 0 开头。 |
版本控制设计
内核版本
定义
搭载 GKI 的设备的内核版本定义如下:
KernelRelease :=
Version.PatchLevel.SubLevel-AndroidRelease-KmiGeneration-suffix
w .x .y -zzz -k -something
如需了解详情,请参阅确定设备的内核版本。
以下是一个内核版本示例。
5.4.42-android12-0-00544-ged21d463f856
说明
内核版本是 GKI 版本的唯一 ID。如果两个 GKI 二进制文件具有相同的内核版本,那它们必须在字节上完全相同。
内核版本由一个 KMI 版本、一个子级和一个后缀组成。在本文档中,KMI 代系之后的后缀将被忽略。
KMI 版本
定义
KMI 版本的定义如下:
KmiVersion :=
Version.PatchLevel-AndroidRelease-KmiGeneration
w .x -zzz -k
请注意,子级 y
不是 KMI 版本的一部分。对于内核版本中的示例,KMI 版本为:
5.4-android12-0
说明
KMI 版本用于描述 GKI 和可动态加载的内核模块 (DLKM) 之间的内核模块接口 (KMI)。
如果两个内核版本具有相同的 KMI 版本,则它们会实现相同的内核模块接口。与其中一个兼容的 DLKM 也会与另一个兼容。
不得通过任何 OTA 更新降低 KMI 版本。
子级
子级 y
用于描述同一 KMI 版本中内核版本的发布顺序。
对于具有相同 KMI 版本但子级分别为 Y1 和 Y2 的两个内核版本:
- 如果 Y1 小于或等于 Y2,那么搭载 Y1 的设备可以接收 Y2 更新。
- 如果 Y1 大于 Y2,那么搭载 Y1 的设备无法更新到 Y2。
也就是说,如果 KMI 版本未更改,就无法通过任何 OTA 更新降低子级。
确定设备的内核版本
通过以下代码段执行 uname -r
或 uname(2)
,即可找到完整的内核版本:
std::string get_kernel_release() {
struct utsname buf;
return uname(&buf) == 0 ? buf.release : "";
}
示例输出如下:
5.4.42-android12-0-00544-ged21d463f856
在本文档中,系统在提取内核信息时会忽略 KMI 代系之后的任何内容。更正式地讲,uname -r
的输出将使用以下正则表达式进行解析(假设 zzz 始终以“android”开头):
^(?P<w>\d+)[.](?P<x>\d+)[.](?P<y>\d+)-(?P<z>android\d+)-(?P<k>\d+).*$
忽略的信息可以包括 ci.android.com build 号、基准内核之上的补丁数量,以及 Git 提交的 SHA 哈希值。
libkver
libkver 库提供了一个用于解析内核版本或 KMI 版本字符串的 C++ 接口。 如需查看 libkver 公开的 API 列表,请参阅 packages/modules/Gki/libkver/include/kver
。
VINTF 检查
对于 Android 11 或更低版本,KMI 版本的 Android 版本部分由设备制造商在设备清单中手动指定。如需了解详情,请参阅 VINTF 内核匹配规则。
从 Android S 开始,可以在构建时从内核提取 KMI 版本的 Android 版本部分并将其注入设备清单中。
由于内核配置要求通常不会更改,因此无需在兼容性矩阵中对 k
进行编码。不过,万一需要更改内核配置要求,请确保以下几点:
- 从兼容性矩阵中移除相应要求。
- 添加额外的 VTS 测试,用于检查 KMI 代系方面的新要求。
OTA 元数据中的启动映像版本
即使启动映像通过 OTA 执行更新,也必须以 OTA 载荷格式 payload.bin
进行封装。OTA 载荷会对每个分区的 version
字段进行编码。当 update_engine
处理 OTA 载荷时,它会比较此字段,确保相应分区不会被降级。
为避免混淆,OTA 元数据中 boot 分区的 version
字段称为 boot image version
。
由于 ramdisk 始终从头开始构建,因此,使用 ramdisk 时间戳就可以充分描述整个启动映像。无需将内核版本编码到启动映像版本,除非您将来要将旧启动映像拼接到新的内核二进制文件中。
在 OTA 更新之前,OTA 客户端会以与任何其他分区相同的方式检查启动映像版本。