Android kernel源码下载与编译

本页详细介绍了为 Android 设备构建自定义内核的流程。以下说明会逐步指导您如何选择正确的源代码，编译内核，以及将结果嵌入到根据 Android 开源项目 (AOSP) 编译的系统映像中。

您可以使用 Repo 获取最新的内核源代码，并通过在源代码检出的根目录下运行 build/build.sh 来编译这些内核源代码，而无需更多配置。

注意：内核源代码检出的根目录包含 build/build.sh。Android 树仅包含预编译的内核二进制文件。内核树包含内核源代码和用于编译内核的所有工具，包括此脚本。

对于较旧的内核或下文未列出的内核，请参阅有关如何编译旧版内核的说明。

下载源代码和编译工具

对于最新的内核，可以使用 repo 下载源代码、工具链和编译脚本。一些内核（例如 Pixel 3 内核）需要从多个 Git 代码库获取源代码，而其他内核（如通用内核）只需从一个 Git 代码库获取源代码。使用 repo 方法可确保源目录设置正确。

下载相应分支的源代码：

下表列出了可通过此方法获取的内核的 BRANCH 名称。

注意：您可以在一个 Repo 检出中切换不同的分支。通用内核清单（以及大多数其他清单）定义了要完全克隆（非浅克隆）的内核 git 代码库，这使您能够在这些分支之间快速切换。切换到不同的分支类似于初始化分支；-u 参数是可选的。例如，要从现有的 repo 检出切换到 common-android-mainline，请运行以下命令：
$ repo init -b common-android-mainline && repo sync。

构建内核

然后使用以下脚本构建内核：

注意：通用内核是通用的可自定义内核，因此不会定义默认配置。如需了解如何为通用内核指定编译配置，请参阅自定义内核编译。

内核二进制文件、模块和相应的映像位于 out/BRANCH/dist 目录下。

运行内核

您可以通过多种方式运行自定义编译的内核。下面介绍了几种适合各种开发场景的已知方法。

嵌入到 Android 映像编译中

将 Image.lz4-dtb 复制到 AOSP 树中相应的内核二进制位置，然后重新编译启动映像。

或者，您也可以在使用 make bootimage（或用于编译启动映像的任何其他 make 命令行）时定义 TARGET_PREBUILT_KERNEL 变量。所有设备均支持该变量，因为它是通过 device/common/populate-new-device.sh 进行设置的。例如：

使用 fastboot 刷新和启动内核

最新的设备具有引导加载程序扩展，可以简化生成和启动启动映像的过程。

要启动内核而不刷新，请运行以下命令：

使用此方法时，内核实际上并未刷新，因此不会在重新启动时保留。

注意：内核名称因设备而异。要找到内核的正确文件名，请参阅 AOSP 树中的 device/VENDOR/NAME-kernel。

自定义内核编译

编译流程和结果可能会受环境变量的影响。它们中的大多数是可选的，并且每个内核分支都应该具有适当的默认配置。此处列出了最常用的变量。如需完整（且最新）的列表，请参阅 build/build.sh。

本地构建的自定义内核配置

如果您需要定期切换内核配置选项（例如，在开发某项功能时），或者需要设置一个用于开发用途的选项，可以通过维护编译配置的本地修改或副本来实现这种灵活性。

将 POST_DEFCONFIG_CMDS 变量设为一个在常规 make defconfig 步骤完成后立即接受评估的语句。由于 build.config 文件源于编译环境，因此 build.config 中定义的函数可以作为 post-defconfig 命令的一部分进行调用。

一个常见示例是在开发期间针对 crosshatch 内核停用链接时优化 (LTO)。虽然 LTO 对已发布的内核有益，但编译时产生的开销可能巨大。添加到本地 build.config 的以下代码段将在使用 build/build.sh时永久停用 LTO。

确定内核版本

您可以通过多种方式确定要构建的正确版本。

AOSP 树中的内核版本

AOSP 树包含预编译的内核版本。大多数情况下，git 日志会在提交消息中显示正确的版本：

系统映像中的内核版本

如需确定系统映像中使用的内核版本，请对内核文件运行以下命令：

对于 Image.lz4-dtb 文件，请运行以下命令：