APFTool升级版
瑞芯微固件解包工具

apftool-rs是基于Rust开发的现代化apftool替代方案,专为瑞芯微(RockChip)固件解包而设计。相比传统apftool,提供更好的性能、安全性和跨平台支持。支持RKFW和RKAF格式,是专业的apftool升级版工具。

核心功能

全面支持瑞芯微固件解包所需的一切功能

RKFW支持

轻松解包RKFW固件文件,提取嵌入的RKAF更新镜像。

芯片支持

支持多种瑞芯微芯片系列:RK29xx、RK30xx、RK31xx、RK32xx、RK3368、RK3326、RK3566、PX30。

跨平台

在Windows、macOS和Linux上无缝运行,提供自动化CI/CD构建。

快速可靠

基于Rust构建,提供最佳性能和内存安全。高效处理大型固件文件。

简易CLI

简单的命令行界面,易于使用和集成到您的工作流程中。

开源项目

完全开源,采用Apache License 2.0协议。可根据需要贡献和定制。

使用步骤

三步完成固件解包

1

下载安装

从GitHub Releases下载对应平台的预编译二进制文件,或使用源码编译安装。

Terminal
curl -L https://github.com/suyulin/apftool-rs/releases/latest/download/apftool-rs-linux-x86_64 -o apftool-rs
chmod +x apftool-rs
2

解包RKFW固件

使用apftool-rs解包RKFW固件文件,工具会自动识别固件格式并提取内容。

Terminal
./apftool-rs firmware.img ./output
3

提取嵌入镜像

如果RKFW中包含嵌入的RKAF更新镜像,可以进一步解包提取具体的分区镜像。

Terminal
./apftool-rs ./output/embedded-update.img ./output

效果展示

实际使用效果和输出示例

RKFW解包输出

apftool-rs会显示固件的详细信息,包括版本、芯片型号和分区布局:

$ apftool-rs rk.img ./out
RKFW signature detected
version: 8.1.0
family: PX30
00000066-0004c1b3 BOOT (size: 311630)
0004c1b4-a2e8c9b7 embedded-update.img (size: 2732853252)

RKAF解包输出

解包RKAF格式会提取出完整的Android固件分区:

$ apftool-rs ./out/embedded-update.img ./out
Filesize: 2732853252
manufacturer: RK3326
model: RK3326
00000800-000002eb ./out/package-file
00001000-0004c14e ./out/Image/MiniLoaderAll.bin
0004d800-0000031f ./out/Image/parameter.txt
0004e000-00400000 ./out/Image/trust.img
0084e000-0000c000 ./out/Image/misc.img
00a2e000-012b8814 ./out/Image/kernel.img
01ce7000-0016a40c ./out/Image/boot.img
01e51800-026a07c4 ./out/Image/recovery.img
628ec800-0c82b0a0 ./out/Image/oem.img
6f118000-33d28274 ./out/Image/update_back.img

安装方式

预编译二进制

从GitHub Releases下载适用于Windows、macOS和Linux的版本

源码编译

cargo build --release

性能特点

  • 快速解包大型固件文件
  • 内存安全,无缓冲区溢出
  • 自动检测固件格式
  • 详细的解包信息输出

开源社区驱动

加入社区,共同参与项目开发

8+
星标
3
贡献者
3
发布版本

支持的格式和芯片

文件格式

  • RKFW - 瑞芯微固件包装格式
  • RKAF - 瑞芯微Android固件包格式

芯片系列

rk29xx (0x50)
rk30xx (0x60)
rk31xx (0x70)
rk32xx (0x80)
rk3368 (0x41)
RK3326 (0x36)
RK3566 (0x38)
PX30 (0x30)