Kernel构建工具kernel_build_action中boot.img生成问题的分析与解决

Kernel构建工具kernel_build_action中boot.img生成问题的分析与解决

kernel_build_action a action to build kernel automatically 项目地址: https://gitcode.com/gh_mirrors/ke/kernel_build_action

问题背景

在Android内核开发过程中，kernel_build_action是一个常用的GitHub Actions工具，用于自动化构建内核镜像。近期在使用该工具时，发现了一个影响boot.img生成的关键问题——当使用AIK-magisk工具解包boot.img时，会出现"cpio: Cannot mknod: Operation not permitted"的错误，导致整个构建过程失败。

问题根源分析

经过深入排查，发现问题出在AIK-magisk工具的unpackimg脚本中。该脚本在最后一步会尝试解压ramdisk内容：

cd $RPWD/ramdisk
cpio -i < $RPWD/split/ramdisk.cpio

这一操作在GitHub Actions环境下会失败，因为该环境不允许创建设备节点(如/dev/null和/dev/console)，而这是ramdisk中的常见内容。错误表现为：

cpio: dev/null: Cannot mknod: Operation not permitted
cpio: dev/console: Cannot mknod: Operation not permitted

解决方案演进

第一阶段：绕过不必要的解包

实际上，生成boot.img并不需要解压ramdisk内容。我们只需要使用magiskboot工具来解包和重新打包boot.img。因此，解决方案是直接使用magiskboot工具，而完全跳过AIK-magisk的unpackimg脚本。

第二阶段：架构适配与下载修复

在实现这一方案时，遇到了几个技术挑战：

1. 架构检测问题：GitHub Actions运行环境的架构检测与本地不同，导致magiskboot工具下载失败。通过简化架构检测逻辑并移除不必要的GETTEXT调用解决了这一问题。

2. 下载工具参数错误：最初使用了错误的aria2c参数（-O代替-o），导致下载失败。修正参数后解决了下载问题。

3. 工作目录问题：由于工作目录切换不当，导致boot.img下载到了错误的路径。通过调整目录切换顺序解决了路径问题。

第三阶段：KernelSU模块支持

在解决boot.img生成问题后，又遇到了KernelSU作为可加载内核模块(LKM)的构建问题。经分析发现：

1. KernelSU的LKM功能仅支持GKI内核(内核版本≥5.10)
2. 对于非GKI内核(如5.4)，必须禁用ksu-lkm选项

技术要点总结

1. 环境限制：GitHub Actions环境有严格的安全限制，不允许创建设备节点等特殊文件操作。

2. 工具选择：在内核构建过程中，应根据实际需求选择最小必要的工具集，避免执行多余操作。

3. 路径管理：自动化脚本中需要特别注意工作目录的切换和文件路径的处理。

4. 版本兼容性：内核模块开发必须考虑内核版本兼容性，特别是对于依赖特定内核特性的功能。

最佳实践建议

1. 对于boot.img处理，优先使用magiskboot等专用工具，而非完整的解包工具链。

2. 在GitHub Actions中编写脚本时，应充分考虑环境限制，避免依赖特殊文件系统操作。

3. 使用KernelSU时，务必检查内核版本与功能兼容性：

   • ≥5.10的内核可使用LKM模式
   • <5.10的内核应使用传统集成方式

4. 自动化构建脚本应包含完善的错误处理和日志输出，便于问题排查。

结论

通过分析kernel_build_action工具中boot.img生成失败的问题，我们不仅解决了具体的技术障碍，还总结出了一套在受限环境下处理Android内核镜像的最佳实践。这些经验对于Android内核开发者具有普遍参考价值，特别是在持续集成环境下的内核构建工作流优化方面。

kernel_build_action a action to build kernel automatically 项目地址: https://gitcode.com/gh_mirrors/ke/kernel_build_action