自行打包 update.img 的方法

自行打包 update.img 的方法

  • 作者:吴思含(Witheart)
  • 更新时间:20250621

概要:本文介绍了如何在 Linux 环境下通过 Android SDK 的工具自行打包 update.img 文件。详细说明了工具目录、脚本选择方法、变量配置方式,以及打包流程和注意事项。


1. 打包环境准备

一般都是在 Linux 环境 下进行打包。

进入 Android SDK 源码目录后,打包工具位于以下路径:

复制代码
RKTools/linux/Linux_Pack_Firmware/rockdev

该目录下包含多个脚本文件,需根据具体的版型选择合适的脚本进行打包。

图片示例:


2. 如何选择正确的打包脚本

如果不确定使用哪个脚本,可以查阅 SDK 根目录下的 build.sh 中关于 make updateimg 部分的代码逻辑:

sh 复制代码
if [ "$BUILD_UPDATE_IMG" = true ] ; then
    cp logo-img/nk-logo.img $IMAGE_PATH/	
    mkdir -p $PACK_TOOL_DIR/rockdev/Image/
    cp -f $IMAGE_PATH/* $PACK_TOOL_DIR/rockdev/Image/

    echo "Make update.img"
    if [[ $TARGET_PRODUCT =~ "PX30" ]]; then
	cd $PACK_TOOL_DIR/rockdev && ./mkupdate_px30.sh
    elif [[ $TARGET_PRODUCT =~ "rk356x_box" ]]; then
	if [ "$BUILD_AB_IMAGE" = true ] ; then
		cd $PACK_TOOL_DIR/rockdev && ./mkupdate_ab_$TARGET_PRODUCT.sh
	else
		cd $PACK_TOOL_DIR/rockdev && ./mkupdate_$TARGET_PRODUCT.sh
	fi
    else
	if [ "$BUILD_AB_IMAGE" = true ] ; then
		cd $PACK_TOOL_DIR/rockdev && ./mkupdate_"$TARGET_BOARD_PLATFORM"_ab.sh
	else
		cd $PACK_TOOL_DIR/rockdev && ./mkupdate_$TARGET_BOARD_PLATFORM.sh
	fi
    fi

    if [ $? -eq 0 ]; then
        echo "Make update image ok!"
    else
        echo "Make update image failed!"
        exit 1
    fi
    cd -
    mv $PACK_TOOL_DIR/rockdev/update.img $IMAGE_PATH/ -f
    rm $PACK_TOOL_DIR/rockdev/Image -rf
fi

变量说明

  • $TARGET_PRODUCT:产品型号
  • $TARGET_BOARD_PLATFORM:平台型号

可以通过在终端中使用 echo 命令查看这两个变量的值:

sh 复制代码
echo $TARGET_PRODUCT
echo $TARGET_BOARD_PLATFORM

3. 打包前的准备工作

在使用打包工具之前,需要完成以下准备:

  1. 在 RKTools/linux/Linux_Pack_Firmware/rockdev 目录下创建 Image 文件夹:

    sh 复制代码
    mkdir -p RKTools/linux/Linux_Pack_Firmware/rockdev/Image
  2. 将所有需要打包的镜像文件和分区表文件(如 boot.img、system.img、parameter.txt 等)放入该目录中。

    这些文件通常位于 rockdev 目录中,是平时生成的镜像文件。


4. 执行打包命令

根据平台执行相应脚本,例如:

sh 复制代码
./RKTools/linux/Linux_Pack_Firmware/rockdev/mkupdate_rk356x.sh

执行后将在以下两个位置生成 update.img:

  • ./RKTools/linux/Linux_Pack_Firmware/rockdev/Image/update.img
  • ./RKTools/linux/Linux_Pack_Firmware/rockdev/update.img

刷写时请使用后者,因为前者未包含 MiniLoaderAll.bin,烧录工具无法识别。

相关推荐
工业一体机老司机21 分钟前
工业一体机选购后的系统部署:Ubuntu下Docker容器化运行与GPIO配置
linux·ubuntu·docker·人机交互
夏虫不可与之言冰1 小时前
Windows WSL2 (Ubuntu) 搭建 ESP‑IDF 6.1 开发环境全过程演示
linux·windows·ubuntu·esp32·乐鑫科技·乐鑫eim·乐鑫代理商
人生百态,人生如梦5 小时前
Ubuntu在低版本下使用ccswitch+claudecode(CCSwitch+Docker+Claude)连调教程
linux·ubuntu·docker·claudecode·ccswitch
坐看风云变幻7 小时前
Betaflight 开发环境搭建保姆级教程(Ubuntu / Windows+WSL / Docker 三方案 + 官方网址大全)
windows·ubuntu·docker·无人机·飞控·betaflight
远牧8 小时前
Ubuntu 26 升级踩坑实录:hermes-agent venv 重建全过程
linux·ubuntu·ai·agent
眼不痛请看我8 小时前
Ubuntu_22.04_LTS虚拟机安装指南
linux·数据库·ubuntu
缘友一世9 小时前
校园网有线网络排查(NetworkManager与netplan的坑)
ubuntu·校园网
大鹏的NLP博客1 天前
WSL Ubuntu 26.04 升级与环境整理记录
linux·ubuntu·wsl
忆挽篱笙歌1 天前
gdb/cgdb
linux·ubuntu
成为你的宁宁1 天前
【Ubuntu 18.04安装Gitlab】
ubuntu·gitlab