payload.bin结构解析常见问题

Question

在解析Android OTA升级包中的`payload.bin`文件时，常遇到“无法读取操作数据”问题。该文件采用Protocol Buffers格式封装增量更新指令，需通过`update_payload`工具解析。常见问题包括：未正确提取二进制流、缺少签名验证导致头部校验失败、或未跳过头部长度字段（通常为4字节魔数后紧跟的偏移量）。此外，不同Android版本的`payload.bin`结构可能存在差异，如V3与V4格式不兼容，导致解析失败。开发者常因未使用对应版本的解析脚本而获取空操作列表。如何准确定位载荷头、正确读取manifest及后续chunks，成为成功解析的关键难点。

Answer 1

1. 常见问题分析：为何无法读取操作数据？

在解析 Android OTA 升级包中的 payload.bin 文件时，开发者常遭遇“无法读取操作数据”的错误。该问题的表层原因多为使用了不兼容的解析工具或脚本版本。例如，在 Android 10 及以上系统中引入的 V4 格式 payload 与早期 V3 不兼容，若仍使用旧版 update_payload 解析器，则会因结构差异导致 manifest 解析失败，返回空操作列表。

• 未正确提取二进制流：直接从 zip 包中解压后未校验完整性
• 缺少签名验证机制：跳过头部签名块将触发校验失败
• 忽略魔数与偏移量：payload 头部包含 4 字节魔数（"CrAU"）和紧随其后的长度字段（通常为 uint32）
• 格式版本错配：V3 使用简单 protobuf 结构，而 V4 引入压缩和分段元数据

2. 解析流程深度剖析：从载荷头到 chunks 的完整路径

要成功解析 payload.bin，必须遵循严格的字节流处理顺序。以下是标准解析流程：

1. 读取前 4 字节，验证是否为魔数 "CrAU"（ASCII 小端序）
2. 读取接下来的 4 字节 uint32，表示 header size
3. 跳转至 offset = 8 + header_size 处，定位 protobuf-encoded manifest
4. 使用 payload_metadata.proto 定义反序列化 manifest
5. 根据 manifest 中的操作指令（install_operation）遍历所有 data_offset 和 data_length
6. 逐个读取 chunk 并应用差分算法（如 bsdiff、brillo_update_payload）
7. 验证每个操作的签名哈希（若启用 AVB 验证）
8. 输出原始镜像修改路径（如 system、vendor 分区变更）

字段	偏移量	类型	说明
magic	0x00	uint32	"CrAU" (0x43724155)
header_size	0x04	uint32	头部长度（通常为 68~1024 字节）
manifest	0x08	protobuf	包含分区操作列表
signatures	动态	bytes	用于完整性校验
data_blobs	末尾对齐	raw chunks	实际写入数据块

3. 实战代码示例：Python 脚本精准定位 manifest

import struct
from google.protobuf import text_format
import update_metadata_pb2

def parse_payload_header(f):
    magic = f.read(4)
    if magic != b'CrAU':
        raise ValueError("Invalid magic number")
    
    header_size_bytes = f.read(4)
    header_size = struct.unpack('<I', header_size_bytes)[0]  # 小端 uint32
    
    header_data = f.read(header_size)
    manifest = update_metadata_pb2.DeltaArchiveManifest()
    manifest.ParseFromString(header_data)
    
    return manifest

# 使用方式
with open('payload.bin', 'rb') as f:
    manifest = parse_payload_header(f)
    print(text_format.MessageToString(manifest))

4. 工具链适配与版本兼容性策略

不同 Android 版本使用的 payload 格式存在显著差异：

Android 8-9 (V3)

无压缩，manifest 直接紧跟 header，chunk 地址连续

Android 10+ (V4)

支持 ZSTD 压缩，manifest 内含 compression_info，需预解压 data blob

Android 12+

引入 AVB 签名嵌套，必须验证 JWS signature before parsing

graph TD
    A[打开 payload.bin] --> B{读取魔数 CrAU?}
    B -- 否 --> C[报错: 非标准格式]
    B -- 是 --> D[读取 header_size]
    D --> E[跳转至 manifest 起始位置]
    E --> F{是否启用签名?}
    F -- 是 --> G[验证 JWS Signature]
    F -- 否 --> H[解析 DeltaArchiveManifest]
    G --> H
    H --> I[提取 install_operations]
    I --> J[按 data_offset 读取 chunks]
    J --> K[输出增量更新内容]