系列第 4 / 6 篇 · 承接第 3 篇《三条升级链路》
系列目录(规划):
- 总览:A/B 无缝升级架构与核心组件
- OTA 包的构成与生成:payload.bin / metadata / otacert 与
ota_from_target_files- 升级链路:Java
UpdateEngine、自研 HAL 与 TR069 / MQTT 三条路怎么选- update_engine 内部机制:Action 流水线、下载、校验与 postinstall(本篇)
- 切槽、回滚保护与升级后首启:bootctl HAL、update_verifier、checkpoint
- 非 A/B 设备对照:传统 Recovery 升级、sideload 与现场刷机(附 A9 设备移植对照)
说明:产品名、设备名、平台路径一律用中性写法(
device_x//dev/block/by-name/)。 本篇的实测数据来自一台真机上一次完整升级(Android 14、A/B、Virtual A/B 开启、1.23 GB full 包), 日志已做路径归一,不影响任何结论。
0. 本篇要解决的问题
第 3 篇讲清了"谁来调 applyPayload"。这一篇回答它返回之前那几分钟里,引擎自己做了什么:
applyPayload一进来就打出一份InstallPlan:,那份东西是谁填的、每个字段决定什么?- 一次升级到底跑几个 Action?为什么日志里
DownloadAction之后还要再"校验"一遍? payload.bin是边下边解还是先落盘?1.4 GB 的包会不会在/data里再占一份?- 全量包和增量包在写盘路径上差在哪,为什么增量包写得更慢?
PostinstallRunnerAction到底是"跑脚本"还是"切槽"?切槽那一行代码在哪?- 升级卡在 3% / 4% / 5% 不动,分别卡在哪个环节?
一句话答案先给出来:引擎把一次升级拆成 6 个首尾相接的 Action,串成一条流水线; 真正干活的是 DownloadAction(取包 + 校验 + 写盘一体),切槽藏在最后一个 Action 的完成回调里。
1. 三层结构:谁在指挥,谁在干活
scss
UpdateAttempterAndroid ← 门面:接 Binder 请求、组装 InstallPlan、建流水线
│ BuildUpdateActions(fetcher)
▼
ActionProcessor ← 调度:一次只跑一个 Action,失败即中断
│ Enqueue × 6 + BondActions 串成管道
▼
Action × 6 ← 干活:每个 Action 只做一件事,输出传给下一个
建流水线的全部代码就在一个函数里:
cpp
// system/update_engine/aosp/update_attempter_android.cc:782
void UpdateAttempterAndroid::BuildUpdateActions(HttpFetcher* fetcher) {
auto update_boot_flags_action = std::make_unique<UpdateBootFlagsAction>(boot_control_);
auto cleanup_previous_update_action = ...GetCleanupPreviousUpdateAction(...);
auto install_plan_action = std::make_unique<InstallPlanAction>(install_plan_);
auto download_action = std::make_unique<DownloadAction>(prefs_, boot_control_, hardware_,
fetcher, true, update_certificates_path_);
auto filesystem_verifier_action = std::make_unique<FilesystemVerifierAction>(...);
auto postinstall_runner_action = std::make_unique<PostinstallRunnerAction>(...);
BondActions(install_plan_action.get(), download_action.get()); // :810
BondActions(download_action.get(), filesystem_verifier_action.get()); // :811
BondActions(filesystem_verifier_action.get(), postinstall_runner_action.get()); // :812
processor_->EnqueueAction(std::move(update_boot_flags_action));
processor_->EnqueueAction(std::move(cleanup_previous_update_action));
processor_->EnqueueAction(std::move(install_plan_action));
processor_->EnqueueAction(std::move(download_action));
processor_->EnqueueAction(std::move(filesystem_verifier_action));
processor_->EnqueueAction(std::move(postinstall_runner_action));
}
BondActions(system/update_engine/common/action_pipe.h:93)做的是类型安全的数据管道: 上游 Action 的输出类型必须等于下游的输入类型,编译期就检查。所以"Action 顺序"不是约定,是被类型钉死的。
调度器非常简单:一个队列,一次一个,失败就清空队列。
cpp
// system/update_engine/common/action_processor.cc:143(启动下一个)
LOG(INFO) << "ActionProcessor: starting " << current_action_->Type();
// :116(上一个结束,带错误码)
LOG(INFO) << "ActionProcessor: finished "
<< (actions_.empty() ? "last action " : "") << old_type
<< " with code " << utils::ErrorCodeToString(code);
1.1 六个 Action 的分工
| # | Action | 干什么 | 失败会怎样 |
|---|---|---|---|
| 1 | UpdateBootFlagsAction |
把当前 槽标记为"启动成功"(Marking booted slot as good.) |
通常只告警,不阻断 |
| 2 | CleanupPreviousUpdateAction |
收尾上一次 VABC 升级的 snapshot merge | 失败会残留 COW 空间 |
| 3 | InstallPlanAction |
什么都不做,只把 InstallPlan 传给下游(install_plan.h:227-232) |
不会失败 |
| 4 | DownloadAction |
重头戏:取包 + 验签 + 逐 op 写目标槽 + 建快照 | 绝大多数失败在这一步 |
| 5 | FilesystemVerifierAction |
对写过的分区重算整分区 hash 与计划值比对 | 校验失败 = 写坏了 |
| 6 | PostinstallRunnerAction |
挂载目标分区 → 跑 postinstall 脚本 → 切 active slot | 切槽失败 = kPostinstallRunnerError |
1.2 真机上一次完整升级的时间线
以下是同一台设备、同一次升级的引擎日志(已裁剪、路径归一):
text
14:07:54.579 action_processor.cc(143) starting UpdateBootFlagsAction
14:07:54.580 update_boot_flags_action.cc(45) Marking booted slot as good.
14:07:54.584 action_processor.cc(116) finished UpdateBootFlagsAction with code kSuccess
14:07:54.593 action_processor.cc(143) starting CleanupPreviousUpdateAction
14:07:54.616 cleanup_previous_update_action.cc(297) Can't find any snapshot to merge.
14:07:54.622 action_processor.cc(116) finished CleanupPreviousUpdateAction with code kSuccess
14:07:54.623 action_processor.cc(143) starting InstallPlanAction
14:07:54.624 action_processor.cc(116) finished InstallPlanAction with code kSuccess
14:07:54.625 action_processor.cc(143) starting DownloadAction
14:07:54.627 download_action.cc(85) Marking new slot as unbootable
14:07:54.644 delta_performer.cc(984) Verifying using certificates: /system/etc/security/otacerts.zip
14:07:54.666 delta_performer.cc(1022) Detected a 'full' payload.
14:07:54.784 dynamic_partition_control_android.cc(351) Loaded metadata from slot A in .../super
14:07:56.452 snapshot.cpp(3421) For partition system_b, device size = 1433763840, ...
...(product_b / vendor_b / odm_b / system_ext_b / *_dlkm_b 依次建快照)
14:12:28.162 delta_performer.cc(109) Completed 942/942 operations (100%), 1318537616/1318537616 bytes
14:12:28.346 delta_performer.cc(984) Verifying using certificates: /system/etc/security/otacerts.zip
14:12:28.351 delta_performer.cc(1291) Payload hash matches value in payload.
14:12:28.359 action_processor.cc(116) finished DownloadAction with code kSuccess
14:12:28.360 action_processor.cc(143) starting FilesystemVerifierAction
14:12:39.799 filesystem_verifier_action.cc(493) Hash of vendor_dlkm: 9FA7CB63...
14:12:39.846 action_processor.cc(116) finished FilesystemVerifierAction with code kSuccess
14:12:39.848 action_processor.cc(143) starting PostinstallRunnerAction
14:12:39.874 hardware_android.cc(110) vbmeta digest for target slot: E994C900...
14:12:40.507 postinstall_runner_action.cc(454) Unmapped all partitions.
14:12:40.508 postinstall_runner_action.cc(471) All post-install commands succeeded
14:12:40.517 action_processor.cc(116) finished last action PostinstallRunnerAction with code kSuccess
14:12:40.519 update_attempter_android.cc(583) Processing Done.
14:12:40.529 update_attempter_android.cc(826) Writing update complete marker, slot 0, boot id: ...
14:12:40.542 update_attempter_android.cc(600) Update successfully applied, waiting to reboot.
整段 286 秒 ,其中 DownloadAction 占 274 秒(96%),校验 11.5 秒,postinstall 0.7 秒。
一个容易被误判的点:
delta_performer.cc(984)那行Verifying using certificates会出现两次 。 第一次是打开 payload 时创建校验器(delta_performer.cc:354→CreatePayloadVerifier()), 第二次是收完 signature blob 后真正验签(:1268)。看到两次不代表校验了两遍包。
2. InstallPlan:这一次升级的"施工单"
applyPayload 进来后第一件事就是打这份东西(update_attempter_android.cc:323):
cpp
LOG(INFO) << "Using this install plan:";
install_plan_.Dump(); // payload_consumer/install_plan.cc:78-79
真机上的关键字段(节选):
text
InstallPlan:
type: new_update
source_slot: A
target_slot: B
urls: () ← 空!因为是 file:// 走 fetcher,不走 curl
size: 1318537616 ← payload.bin 自身大小(zip 是 1318544576)
metadata_size: 54274
hash: 2B2185D71174F052ECC2D11E8119900FD0249C9A939BECA0F8CFB4A2977A8D24
hash_checks_mandatory: true
powerwash_required: false
switch_slot_on_reboot: true ← 决定最后要不要切槽
run_post_install: true
is_rollback: false
Partition: boot
source_size: 0 source_path: ← 全量包:没有源分区
target_size: 67108864 target_path: /dev/block/by-name/boot_b
target_hash: DA66A77A10F3DE7D3E129F498059B87F3219B9EA804114064E6B5B8825ECC93A
run_postinstall: false postinstall_path:
每个字段决定什么,这张表要背:
| 字段 | 谁填 | 决定什么 |
|---|---|---|
source_slot / target_slot |
bootctl HAL 查询 | 写哪个槽;A/B 一切路径都从这两个值推 |
urls |
Binder 入参 | 空 = 由 HttpFetcher 取(file://);非空 = DownloadAction 用 libcurl 拉 |
size / metadata_size / hash |
payload_properties.txt(第 2 篇四个头) |
整包完整性校验的基准 |
hash_checks_mandatory |
hardware_->IsOfficialBuild()(update_attempter_android.cc:268,判据是 ro.secure == 1) |
为 false 时 op 级 hash 只 warning 不失败------userdebug 机上"包写坏了也能过"就是这么来的 |
switch_slot_on_reboot |
头里的 SWITCH_SLOT_ON_REBOOT |
决定最后是否 SetActiveBootSlot;false 时返回 52 |
run_post_install |
入参 / 构建期 | 是否跑 postinstall 脚本 |
Partition.source_* |
manifest 的 old_partition_info |
是否增量包的唯一判据:有源分区信息才是增量 |
Partition.target_hash |
manifest 的 new_partition_info |
写完后整分区 hash 的期望值 |
Partition.run_postinstall / postinstall_path |
manifest 的 postinstall 字段 |
该分区要不要跑脚本、跑哪个(相对路径) |
3. Action 1--3:开跑前的三件小事
3.1 UpdateBootFlagsAction:先把"当前槽"认成功
cpp
// system/update_engine/update_boot_flags_action.cc:45
LOG(INFO) << "Marking booted slot as good.";
它调用 boot_control_->MarkBootSuccessfulAsync()。意义:正在跑的槽是好的 , 否则下次重启 bootloader 可能因为 tries_remaining 耗尽而拒绝启动它。这一步和"这次升级"其实无关, 是每次引擎启动都做的自检。
3.2 CleanupPreviousUpdateAction:给上一次升级收尾
Virtual A/B 升级完成后,新旧槽的数据要"合并"(snapshot merge),合并可能跨重启。 这个 Action 负责把上一次没合完的活儿干完:
text
cleanup_previous_update_action.cc(149) Starting/resuming CleanupPreviousUpdateAction
cleanup_previous_update_action.cc(261) Waiting for any previous merge request to complete.
This can take up to several minutes.
cleanup_previous_update_action.cc(297) Can't find any snapshot to merge.
真机上这次是空转(没有待合并的快照),耗时 29 ms。但如果上一次升级留下了未合并的快照, 这里会阻塞几分钟------现场"点了升级半天没动静"有时是卡在这一步,不是卡在下载。
3.3 InstallPlanAction:纯管道
cpp
// system/update_engine/payload_consumer/install_plan.h:227-232
void PerformAction() override {
if (HasOutputPipe()) SetOutputObject(install_plan_);
processor_->ActionComplete(this, ErrorCode::kSuccess);
}
把 InstallPlan 顺着管道递给 DownloadAction,1 ms 完成。
4. Action 4:DownloadAction------取包、验签、写盘,全在这一个 Action 里
名字叫 Download,实际干的是"下载 + 解析 + 校验 + 写盘"。这一节按它的执行顺序走一遍。
4.1 第一件事:把目标槽标成"不可启动"
cpp
// system/update_engine/download_action.cc:85-90
LOG(INFO) << "Marking new slot as unbootable";
if (!boot_control_->MarkSlotUnbootable(install_plan_.target_slot)) {
LOG(WARNING) << "Unable to mark new slot " << ... << ". Proceeding with the update anyway.";
}
为什么先干这个:目标槽此刻还是旧内容 (或半写状态)。把它标成 unbootable, 可以保证"即使现在掉电并被强制从目标槽启动",bootloader 也不会选它。 写完数据后,PostinstallRunnerAction 才会把它重新标成 bootable 并设为 active。
4.2 取数:FileFetcher 还是 libcurl
| 情况 | 用谁 | 依据 |
|---|---|---|
payload_url 是 file:// |
FileFetcher(本地直接读) |
update_attempter_android.cc:327-329 |
payload_url 是 http(s):// |
LibcurlHttpFetcher(Range 分段、续传) |
第 3 篇 §4.3 |
两条路径汇入同一个 DeltaPerformer::Write(buffer, count) :取到一块字节就喂进去解析, 所以"边下边解"是默认行为------payload.bin 不会在 /data 里再落一份拷贝(HAL 那种"先下整包"是调用方自己干的)。
4.3 DeltaPerformer::Write:三段式解析
markdown
字节流 ──▶ ① 24 字节头(CrAU / version / manifest_size / sig_size)
──▶ ② manifest(DeltaArchiveManifest,含每个分区的 ops 列表)
──▶ ③ blob 区(按 ops 顺序消费,边消费边写盘)
- ① 头 :
payload_metadata.cc解析,决定了 manifest 有多长(第 2 篇 §3)。 - ② manifest:读到就立刻判定"全量 or 增量":
cpp
// system/update_engine/payload_consumer/delta_performer.cc:1022
LOG(INFO) << "Detected a '" << InstallPayloadTypeToString(actual_payload_type) << "' payload.";
判据是 manifest 里有没有 old_partition_info(对应 InstallPlan.Partition.source_size/source_path)。 真机打的是 Detected a 'full' payload.,source_size: 0。
- ③ blob 区:按 op 逐条消费。每完成一条就打进度:
text
delta_performer.cc(109) Completed 302/942 operations (32%), 380928000/1318537616 bytes downloaded (28%), overall progress 30%
真机 1.23 GB 全量包一共 942 个 op ;因为它是 full 包,这批 op 里不会有 SOURCE_*, 写盘只走 REPLACE*(以及可能的 ZERO / DISCARD)。
4.4 校验链:五道关卡,各管一段
| # | 时机 | 校验什么 | 代码 | 失败错误码 |
|---|---|---|---|---|
| ① | 打开 payload | otacerts.zip 能否创建校验器 |
delta_performer.cc:354 / :984 |
18 kDownloadPayloadPubKeyVerificationError |
| ② | 解析完 24 字节头 | 头里声明的 metadata_size 是否等于 InstallPlan 里的值(仅 hash_checks_mandatory 时) |
delta_performer.cc:308-315 |
32 kDownloadInvalidMetadataSize |
| ③ | 收完整个 payload | 整包 hash 是否等于 FILE_HASH |
delta_performer.cc:1258-1264 |
10 kPayloadHashMismatchError |
| ④ | 收完 signature blob | 签名能否被 otacert 验证通过 |
delta_performer.cc:1268-1292 |
12 kDownloadPayloadVerificationError |
| ⑤ | 每条 op 执行前 | op 自带的 data_sha256_hash 是否匹配(可关) |
delta_performer.cc:630 附近 |
29 kDownloadOperationHashMismatch |
③④ 都通过时打的就是那句:
text
delta_performer.cc(1291) Payload hash matches value in payload.
注意它说的是"value in payload ":hash 的期望值来自 payload 自己(manifest 的 signatures 段), 而"这份 payload 是不是可信的"由 otacert 的签名保证。两者合起来才叫"验过了"。
一个常见误解 :以为
METADATA_HASH这块头会在 apply 阶段被逐字节比对。 实际上它只有两个用途------ ① 参与payload_id,决定"这次能不能接着上次的进度下载"(update_attempter_android.cc:129-130); ② 供update_engine_client --verify做预检 ,不下载 payload 就判断"这包能不能装到这台机器" (update_attempter_android.cc:486-520的ValidateMetadataSignature)。 apply 阶段真正校验的是"metadata_size 对不对 + 整包 hash + 签名",不是再比一次METADATA_HASH。
4.5 写盘:两种 PartitionWriter,四类 op
写盘入口是 PartitionWriter::PerformReplaceOperation 等(payload_consumer/partition_writer.cc:191/200/228/256), 具体用哪个 Writer 由产品是否开 VABC 决定:
cpp
// system/update_engine/payload_consumer/partition_writer_factory_android.cc:36-42
LOG(INFO) << "Virtual AB Compression Enabled, using VABC Partition Writer for `" << ... << '`';
...
LOG(INFO) << "Virtual AB Compression disabled, using Partition Writer for `" << ... << '`';
真机全是 Virtual AB Compression disabled, using Partition Writer for ...(VABC 压缩没开)。
op 的分派表(delta_performer.cc:647-673):
| op | 处理函数 | 数据从哪来 | 典型场景 |
|---|---|---|---|
REPLACE / REPLACE_BZ / REPLACE_XZ |
PerformReplaceOperation(:191) |
payload 里的 blob | 全量包全部是这个 |
ZERO / DISCARD |
PerformZeroOrDiscardOperation(:200) |
不需要数据 | 大片清零区 |
SOURCE_COPY |
PerformSourceCopyOperation(:228) |
从源分区读 (ExtentReader) |
增量包:目标某段 = 源某段 |
SOURCE_BSDIFF / BROTLI_BSDIFF / PUFFDIFF / ZUCCHINI / LZ4DIFF_* |
PerformDiffOperation(:256) |
源分区读 + 补丁流 | 增量包:二进制差分 |
这张表解释了一个现场常见疑问:为什么增量包"下的少、写的慢" ------ SOURCE_* 要先按 extent 读源分区、再算补丁、再写目标分区,I/O 是"读+写"两份; 全量包只是"写一份 + dm-snapshot 的 COW 记账"。
4.6 快照:为什么写盘前先建 COW
A/B 设备开着 Virtual A/B 时,目标槽和源槽共用同一块物理空间(super 动态分区), 写入目标槽会覆盖源槽数据,所以要先给"即将被覆盖的块"准备 COW(copy-on-write)空间:
text
14:07:54.784 dynamic_partition_control_android.cc(351) Loaded metadata from slot A in .../super
14:07:55.815 snapshot.cpp(3250) Using legacy Virtual A/B (dm-snapshot)
14:07:55.816 partition_cow_creator.cpp(252) Remaining free space for COW: 1593712640 bytes
14:07:56.452 snapshot.cpp(3421) For partition system_b, device size = 1433763840,
snapshot size = 1433763840, cow partition size = 1439371264
14:07:56.463 snapshot.cpp(3490) Successfully created snapshot partition for system_b
14:07:56.464 partition_cow_creator.cpp(252) Remaining free space for COW: 154341376 bytes
真机这组数字很值得看:
| 时刻 | 剩余 COW 空间 | 说明 |
|---|---|---|
| 建快照前 | 1,593,712,640 B(≈1.48 GB) | 预算 |
建完 system_b |
154,341,376 B(≈147 MB) | system 一个分区吃掉 1.35 GB |
建完 vendor_b |
27,312,128 B | |
| 之后各分区 | 0 | 已经用光 |
"剩余 0 但升级继续"不是 bug:COW 空间只在覆盖已有数据 时才消耗,全量包的分区整段重写, 预分配额度用尽后仍能继续(只是掉电后无法回滚该分区)。真正的风险场景是 /data 本来就不够 : 那时 snapshot 创建会直接失败,日志在 snapshot.cpp,错误码通常是 kNotEnoughSpace(60)。 运维口径仍然是那句:/data 预留 = 包大小 + 200 MB。
4.7 断点续跑:靠 prefs 里的三个键
引擎不是"一次不成就重来",它把中间状态写在 /data/misc/update_engine/prefs/(platform_constants_android.cc:33):
| 键 | 作用 |
|---|---|
manifest-bytes |
缓存的 manifest 字节,重启后不用重下 header(download_action.cc:96) |
manifest-signature / payload-hash |
校验用的中间值 |
payload-attempt-number |
第几次尝试(Payload Attempt Number = 1),运维据此统计失败重试 |
InstallPlan.Partition.source_* 之外还有 already_applied 标记(download_action.cc:75-78), 多 payload 场景下跳过已完成的。
4.8 进度条到底是什么:字节比例,不是写盘比例
cpp
// system/update_engine/payload_consumer/delta_performer.cc:105-114
downloaded_percentage_str = base::StringPrintf(
" (%" PRIu64 "%%)", IntRatio(total_bytes_received_, payload_size, 100));
LOG(INFO) << ... << next_operation_num_ << "/" << total_operations_str << " operations"
<< completed_percentage_str << ", " << total_bytes_received_ << "/"
<< payload_size_str << " bytes downloaded" << downloaded_percentage_str
<< ", overall progress " << overall_progress_ << "%";
percent(App 看到的那个)= 已消费字节 / payload 总字节;overall progress= 两个 50% 的加权 :下载字节比例 × 50% + 已完成 op 比例 × 50% (权重常量在delta_performer.cc:70-71,折算逻辑在:117-148)。
这就解释了日志里 ops 32% / bytes 28% → overall 30%:(32+28)/2 = 30。
所以下载快了但写盘慢时,进度会早早爬到 90%+ 然后长时间不动 ------这是正常现象, 不是卡死。真机日志里 bytes 28% → overall 30% 这种小幅差异就来自权重折算。
5. Action 5:FilesystemVerifierAction------把写过的分区再算一遍
它不读 payload,而是直接读目标分区设备节点 ,整分区算 hash 与 InstallPlan.Partition.target_hash 比对:
text
filesystem_verifier_action.cc(387) Hashing partition 9 (system) on device /dev/block/dm-17
filesystem_verifier_action.cc(438) Verity writes disabled on partition system
filesystem_verifier_action.cc(493) Hash of system: A0D914848D22CB4B0F4C59D211A4E968...
几个要点:
- 读的是 dm 设备 (
/dev/block/dm-17),也就是"新槽的 system",不是物理分区------写盘经过 dm-snapshot,读回来才能验证 COW 是否正确。 Verity writes disabled说明这次构建没有在验证阶段写 verity 元数据(write_verity: false), 产物本身已带 verity。- 真机耗时 11.5 秒 ,其中
system一个分区 7.8 秒(1.37 GB,约 180 MB/s 的 sha256 吞吐)。 这解释了"卡在 4% 不动":这一阶段进度按分区权重走,system一动就是好几秒。
这一步和重启后的
update_verifier是两件事 :这里校验的是"写进去的数据 = 包里的数据", 重启后update_verifier校验的是"新槽能正常挂载、dm-verity 通过"(第 5 篇)。
6. Action 6:PostinstallRunnerAction------跑脚本,然后切槽
6.1 它做的三件事
bash
① 挂载配置了 postinstall 的分区到 /postinstall postinstall_runner_action.cc:86/94
② 跑该分区的 postinstall 脚本(相对路径,如 bin/otapreopt_slot) :253-270
③ 全部成功后:SetActiveBootSlot(target) + SetWarmReset + 写 vbmeta digest :431-449
然后 UnmapAllPartitions() :454
真机 dump 里所有分区都是 run_postinstall: false / postinstall_path: 空, 所以 All post-install commands succeeded 其实是"0 条命令成功",0.7 秒基本花在 unmount 和 vbmeta digest 上。
6.2 切槽就这三行
cpp
// system/update_engine/payload_consumer/postinstall_runner_action.cc:431-449
void PostinstallRunnerAction::CompletePostinstall(ErrorCode error_code) {
if (error_code == ErrorCode::kSuccess) {
if (install_plan_.switch_slot_on_reboot) {
if (!boot_control_->SetActiveBootSlot(install_plan_.target_slot)) {
LOG(ERROR) << "Failed to switch slot to " << install_plan_.target_slot;
error_code = ErrorCode::kPostinstallRunnerError; // 5
} else {
hardware_->SetWarmReset(true);
hardware_->SetVbmetaDigestForInactiveSlot(false);
}
} else {
error_code = ErrorCode::kUpdatedButNotActive; // 52
}
}
...
}
这段值得逐字读三遍,因为它同时解释了三个现场问题:
- 切槽发生在"应用阶段的最后一步",不是重启时。重启只是让 bootloader 去读这个新标志位。
switch_slot_on_reboot=false(SWITCH_SLOT_ON_REBOOT=0)时根本不切槽,直接返回 52------ 这就是第 3 篇 §3.5 那个"52 不是失败"的源码依据。SetWarmReset(true)是给 bootloader 的提示(下次重启走 warm reset 路径,省去完整冷启动), 与"切槽"无关,别在日志里把它当成切槽成功的标志。
6.3 postinstall 脚本从哪来
构建期由 META/postinstall_config.txt 生成进 manifest:
python
# build/make/tools/releasetools/ota_utils.py:841-845
postinstall_config = os.path.join(target_dir, "META", "postinstall_config.txt")
if os.path.exists(postinstall_config):
cmd.extend(["--new_postinstall_config_file", postinstall_config])
内容形如"分区名 + 相对脚本路径",脚本本身在目标分区的文件系统里(常见的是 bin/otapreopt_slot, 用于在升级后对新槽做 dex 预编译,避免首启卡)。没有配置就没有这一步,不要看到耗时 0.7 秒就以为漏了。
7. 实测:1.23 GB 全量包的四段耗时
同一次升级的四个阶段(真机、eMMC、Virtual A/B(dm-snapshot)、VABC 压缩关闭):
| 阶段 | 起止 | 耗时 | 占比 |
|---|---|---|---|
| 前三个 Action | 14:07:54.579 → 14:07:54.625 | 46 ms | 0.02% |
| DownloadAction(读 zip + 写槽 + 建快照 + 验签) | 14:07:54.625 → 14:12:28.359 | 273.7 s | 95.7% |
| FilesystemVerifierAction | 14:12:28.360 → 14:12:39.846 | 11.5 s | 4.0% |
| PostinstallRunnerAction(含切槽) | 14:12:39.848 → 14:12:40.517 | 0.67 s | 0.2% |
| 合计 | 286 s |
下载阶段内部再按分区拆(每个分区首次出现 using Partition Writer for 的时间戳之差):
| 分区 | 写入大小 | 耗时 | 折算吞吐 |
|---|---|---|---|
| system | 1367 MB | 207.7 s | 6.6 MB/s |
| vendor | 121 MB | 19.2 s | 6.3 MB/s |
| product | 94 MB | 15.1 s | 6.2 MB/s |
| system_ext | 70 MB | 11.0 s | 6.4 MB/s |
| vendor_boot | 64 MB | 5.7 s | 11.3 MB/s |
| boot | 64 MB | 4.7 s | 13.7 MB/s |
| 其余 10 个 | 合计 ≈ 64 MB | 合计 2.2 s | --- |
结论很直接:system 一个分区占掉 78% 的写盘时间。所以:
- "进度停在个位数到 80% 之间长时间不动" → 大概率在写
system(1.37 GB / 6.6 MB/s ≈ 3.5 分钟); - 吞吐只有 6 MB/s 量级,是 dm-snapshot COW 叠加 eMMC 写的正常量级,不是"引擎有问题";
- 想提速只能从 I/O 层想办法(更好的闪存、或缩短写入链路),改配置解决不了------这也解释了 为什么同一版包在高配机器上 1 分钟、低配机器上 5 分钟。
8. 日志怎么读:三段式定位
引擎日志默认在 /data/misc/update_engine_log/(logging_android.cc:53,每次启动一个文件), prefs 在同级 prefs/ 目录。排障按下面的顺序看,基本不会跑偏:
bash
adb shell ls -l /data/misc/update_engine_log/ # 看有几份、哪份是这次
adb shell grep -n "ActionProcessor: starting\|finished" /data/misc/update_engine_log/<最新>
adb shell grep -n "Detected a\|Payload hash matches\|Marking new slot" /data/misc/update_engine_log/<最新>
| 现象 | 卡在哪 | 先看什么 |
|---|---|---|
进度长时间不动,starting DownloadAction 之后再无输出 |
下载/写盘前段 | 日志里有没有 Marking new slot as unbootable;/data 空间 |
卡在 3%→99% 之间,但 Completed N/942 operations 在涨 |
正在写分区 | 比对 using Partition Writer for 的位置,多半在 system |
卡在 4% 附近,Hashing partition 之后久不动 |
分区校验 | Hash of <大分区> 是否出现;eMMC 是否在报错 |
进度 100% 但迟迟不 finished DownloadAction |
验签收尾 | Verifying using certificates 之后有没有 Payload hash matches |
finished DownloadAction 但报错 |
写盘/校验失败 | 具体 ErrorCode:: 名字,见下表 |
finished last action PostinstallRunnerAction 但报 5 |
切槽失败 | Failed to switch slot to B;bootctl HAL / misc 分区 |
| 全部成功但重启没换版本 | 不是引擎的问题 | 第 5 篇:update_verifier / checkpoint / bootctl |
错误码对照(system/update_engine/common/error_code.h):
| 码 | 常量 | 常见原因 |
|---|---|---|
| 5 | kPostinstallRunnerError |
切槽失败、postinstall 脚本非 0 退出 |
| 9 | kDownloadTransferError |
取包失败(仅 URL 模式) |
| 10 | kPayloadHashMismatchError |
包被改动 / 传坏 |
| 11 | kPayloadSizeMismatchError |
FILE_SIZE 与实际不符 |
| 12 | kDownloadPayloadVerificationError |
验签失败(包与 otacert 不配对) |
| 15 | kNewRootfsVerificationError |
增量包的源分区与期望不符("包不是给这台机器的这个版本") |
| 18 | kDownloadPayloadPubKeyVerificationError |
建不出证书校验器 / 系统里没有 otacerts.zip |
| 29 | kDownloadOperationHashMismatch |
单条 op 的数据 hash 不对(包被篡改或写盘错位) |
| 32 | kDownloadInvalidMetadataSize |
头里 metadata_size 与 METADATA_SIZE 头不一致(换包没换 headers) |
| 47 | kFilesystemVerifierError |
写完读回来 hash 不一致(写坏 / dm 层问题) |
| 52 | kUpdatedButNotActive |
应用成功但没切槽(SWITCH_SLOT_ON_REBOOT=0) |
| 60 | kNotEnoughSpace |
/data 或 COW 空间不足 |
9. 本篇小结
- 一次升级 = 6 个首尾相接的 Action :
UpdateBootFlags → CleanupPreviousUpdate → InstallPlan → Download → FilesystemVerifier → Postinstall, 顺序被BondActions的类型检查钉死(update_attempter_android.cc:782-823)。 InstallPlan是施工单 :switch_slot_on_reboot决定切不切槽、Partition.source_*决定全量/增量、target_hash决定写盘是否算成功。DownloadAction占 96% 的时间:取数(file/curl)→ 三段解析(头/manifest/blob)→ 四道校验 → 逐 op 写目标槽。- 写盘前先
MarkSlotUnbootable、先建 COW ;system一个分区吃掉 78% 的写盘时间和 1.35 GB 的 COW 预算。 - 切槽在
CompletePostinstall里 (postinstall_runner_action.cc:437),switch_slot_on_reboot=false时直接返回 52。 - 进度是"收到的字节比例",不是写盘比例------早到 90% 再长时间不动是正常现象。
- 实测口径:1.23 GB 全量包、eMMC、dm-snapshot,总 286 秒(下载写盘 274 s / 校验 11.5 s / postinstall 0.7 s)。
下一篇预告
第 5 篇《切槽、回滚保护与升级后首启》接着往下走:SetActiveBootSlot 到底写了什么(misc BCB 的 priority / tries_remaining / successful_boot 三字段)、bootloader 怎么据此决定从哪个槽启动、 新槽首启时 update_verifier 为什么"校验通过却只标记一半"、vold checkpoint 与 ActivityManagerService.finishBooting() 谁最后把 successful=true 写下去, 以及首启失败时 rollback-happened 与 APEX 回滚(snapshot rollback)的完整链路。