如何将三星内核Image.gz打包为Android 14设备可刷入的boot.img

问题背景 #

已完成三星内核源码编译，成功生成Image.gz文件，但需要将其打包为可刷入设备的boot.img。

已完成操作流程 #

1. 工具链配置：从三星官方网站下载并解压对应工具链，放置到指定目录。
2. 环境配置：
   • 进入内核源码目录：

     cd kernel-5.10
     

   • 运行gen_build_config.py脚本生成配置：

     python scripts/gen_build_config.py --kernel-defconfig a15_00_defconfig --kernel-defconfig-overlays "entry_level.config" -m user -o ../out/target/product/a15/obj/KERNEL_OBJ/build.config
     

   • 导出编译环境变量：

     export ARCH=arm64
     export CROSS_COMPILE="aarch64-linux-gnu-"
     export CROSS_COMPILE_COMPAT="arm-linux-gnueabi-"
     export OUT_DIR="../out/target/product/a15/obj/KERNEL_OBJ"
     export DIST_DIR="../out/target/product/a15/obj/KERNEL_OBJ"
     export BUILD_CONFIG="../out/target/product/a15/obj/KERNEL_OBJ/build.config"
     

3. 编译操作：运行编译脚本生成Image.gz：

   cd ../kernel
   ./build/build.sh
   

   生成路径：out/target/product/a15/obj/KERNEL_OBJ/kernel-5.10/arch/arm64/boot/Image.gz

打包步骤 #

三星设备的boot.img包含内核、ramdisk、dtb/dtbo等组件，需匹配设备参数打包，以下是可行方案：

1. 使用三星官方打包脚本（优先） #

多数三星内核源码自带mkbootimg相关脚本，位于build/或tools/目录：

• 查找并打开脚本（如mkbootimg.sh），修改路径配置：

  # 示例配置，根据实际路径调整
  KERNEL_IMAGE=../out/target/product/a15/obj/KERNEL_OBJ/kernel-5.10/arch/arm64/boot/Image.gz
  RAMDISK=./ramdisk.img  # 从官方固件提取或自定义ramdisk
  DTB=../out/target/product/a15/obj/KERNEL_OBJ/kernel-5.10/arch/arm64/boot/dts/samsung/[你的设备dtb文件名].dtb
  OUTPUT_BOOT=./boot.img
  

• 执行脚本生成boot.img：

  chmod +x mkbootimg.sh
  ./mkbootimg.sh
  

2. 使用通用mkbootimg工具 #

若无官方脚本，可使用通用工具，需先获取设备的boot参数（从官方boot.img提取）：

• 安装工具（Ubuntu环境）：

  sudo apt install android-tools-mkbootimg android-tools-unpackbootimg
  

• 提取官方boot.img的参数：

  unpackbootimg -i official_boot.img -o ./unpacked_boot
  

  查看unpacked_boot目录下的boot.img.cmdline、boot.img.base、boot.img.pagesize等文件获取参数。
• 执行打包命令，替换为你的实际参数和路径：

  mkbootimg \
  --kernel ../out/target/product/a15/obj/KERNEL_OBJ/kernel-5.10/arch/arm64/boot/Image.gz \
  --ramdisk ./ramdisk.img \
  --dtb ../out/target/product/a15/obj/KERNEL_OBJ/kernel-5.10/arch/arm64/boot/dts/samsung/[你的设备dtb文件名].dtb \
  --base [从官方提取的base地址] \
  --pagesize [从官方提取的pagesize] \
  --cmdline "[从官方提取的cmdline内容]" \
  --output ./boot.img
  

3. 验证打包结果 #

生成后验证boot.img格式：

file boot.img

正常输出应为Android bootimg, kernel size ...类内容，说明打包有效。

内容的提问来源于stack exchange，提问作者POQDavid