payload-dumper-go 使用教程

项目介绍

payload-dumper-go 是一个用 Go 语言编写的 Android OTA 有效负载转储工具。它能够快速且高效地解压 Android OTA 更新包中的有效负载文件。该项目具有以下主要特性：

• 极快的解压缩速度，所有解压缩过程并行执行
• 支持有效负载校验和验证
• 支持包含 payload.bin 的原始 zip 包

安装方法

从源代码编译安装

首先克隆项目仓库：

git clone https://gitcode.com/gh_mirrors/pa/payload-dumper-go
cd payload-dumper-go

然后使用 Go 工具链进行编译：

go build -o payload-dumper-go

二进制文件安装

您也可以从项目发布页面下载预编译的二进制文件，解压后即可使用：

1. 下载适用于您平台的最新二进制文件
2. 解压下载的文件到系统中的一个目录
3. 将该目录添加到系统的 PATH 环境变量中

使用方法

基本用法

要解压一个 OTA 更新包，只需运行：

payload-dumper-go update.zip

或者直接处理 payload.bin 文件：

payload-dumper-go payload.bin

高级选项

该工具提供了多个命令行选项：

# 只列出分区信息而不解压
payload-dumper-go -l payload.bin

# 指定输出目录
payload-dumper-go -o /path/to/output payload.bin

# 只解压特定分区
payload-dumper-go -p system,vendor payload.bin

# 设置并发工作线程数
payload-dumper-go -c 8 payload.bin

功能特性

并行解压缩

payload-dumper-go 使用多线程并行处理，大大提高了处理速度。默认使用 4 个工作线程，可以通过 -c 参数进行调整。

完整性验证

工具会自动验证每个分区的 SHA256 校验和，确保解压文件的完整性。

支持多种压缩格式

支持处理 REPLACE、REPLACE_XZ、REPLACE_BZ 和 ZERO 等操作类型，涵盖 Android OTA 包中常见的压缩格式。

注意事项

• 建议在 SSD 上运行以获得最佳性能，HDD 可能成为性能瓶颈
• 目前不支持增量 OTA（delta）有效负载
• 处理大型 OTA 包时需要足够的磁盘空间

应用场景

系统维护

系统管理员可以使用 payload-dumper-go 来解压和分析 OTA 更新包，以便更好地理解和维护 Android 设备。

开发调试

开发人员可以使用该工具来提取和分析 OTA 更新包中的文件，以便进行调试和测试。

项目结构

payload-dumper-go/
├── main.go           # 主程序入口
├── payload.go        # 有效负载处理逻辑
├── reader.go         # 文件读取工具
├── chromeos_update_engine/  # Chrome OS 更新引擎协议
│   └── update_metadata.pb.go
├── update_metadata.proto    # Protocol Buffers 定义
├── go.mod            # Go 模块定义
└── go.sum           # 依赖校验和

该项目使用 Go 语言编写，依赖于 Protocol Buffers 来处理 Android OTA 包的元数据格式。