AOSP 14 OTA 升级指导(四):update_engine 内部机制——Action 流水线与写盘

系列第 4 / 6 篇 · 承接第 3 篇《三条升级链路》

系列目录(规划):

  1. 总览:A/B 无缝升级架构与核心组件
  2. OTA 包的构成与生成:payload.bin / metadata / otacert 与 ota_from_target_files
  3. 升级链路:Java UpdateEngine、自研 HAL 与 TR069 / MQTT 三条路怎么选
  4. update_engine 内部机制:Action 流水线、下载、校验与 postinstall(本篇)
  5. 切槽、回滚保护与升级后首启:bootctl HAL、update_verifier、checkpoint
  6. 非 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...

几个要点:

  1. 读的是 dm 设备 (/dev/block/dm-17),也就是"新槽的 system",不是物理分区------写盘经过 dm-snapshot,读回来才能验证 COW 是否正确。
  2. Verity writes disabled 说明这次构建没有在验证阶段写 verity 元数据(write_verity: false), 产物本身已带 verity。
  3. 真机耗时 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
    }
  }
  ...
}

这段值得逐字读三遍,因为它同时解释了三个现场问题:

  1. 切槽发生在"应用阶段的最后一步",不是重启时。重启只是让 bootloader 去读这个新标志位。
  2. switch_slot_on_reboot=false(SWITCH_SLOT_ON_REBOOT=0)时根本不切槽,直接返回 52------ 这就是第 3 篇 §3.5 那个"52 不是失败"的源码依据。
  3. 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. 本篇小结

  1. 一次升级 = 6 个首尾相接的 Action :UpdateBootFlags → CleanupPreviousUpdate → InstallPlan → Download → FilesystemVerifier → Postinstall, 顺序被 BondActions 的类型检查钉死(update_attempter_android.cc:782-823)。
  2. InstallPlan 是施工单 :switch_slot_on_reboot 决定切不切槽、Partition.source_* 决定全量/增量、 target_hash 决定写盘是否算成功。
  3. DownloadAction 占 96% 的时间:取数(file/curl)→ 三段解析(头/manifest/blob)→ 四道校验 → 逐 op 写目标槽。
  4. 写盘前先 MarkSlotUnbootable、先建 COW ;system 一个分区吃掉 78% 的写盘时间和 1.35 GB 的 COW 预算。
  5. 切槽在 CompletePostinstall 里 (postinstall_runner_action.cc:437),switch_slot_on_reboot=false 时直接返回 52。
  6. 进度是"收到的字节比例",不是写盘比例------早到 90% 再长时间不动是正常现象。
  7. 实测口径: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)的完整链路。

相关推荐
恋猫de小郭4 小时前
Jetpack Compose 1.13 发布,憋了这么久终有交代了
android·前端·flutter
JMchen1234 小时前
【Android 性能优化实战 60 讲】12 异步 Inflate 实战与痛击:源码拆解原生瓶颈,手写增强版布局预加载框架
android·性能优化·实战·启动优化·异步inflate·x2c
好的佩奇15 小时前
蓝牙之设备角色与连接
android·flutter·蓝牙
雨白1 天前
Android 消息机制剖析:从 Handler 投递到 Looper 循环的全链路
android
GY-931 天前
【Android】数据分层和依赖注入
android
传奇开心果编程1 天前
【Jetpack Compose娓娓道来】第44课:持久化——让数据“关掉App也不丢”
android·kotlin·移动开发·数据持久化·jetpack compose·ui框架·声明式ui
星空孤辰1 天前
【camera 008】android camera id 注册、状态监控等状态变化 全流程梳理
android·windows
恋猫de小郭1 天前
iOS for Web ,把原生 iOS App 跑到进浏览器里面,倒反天罡
android·前端·ios
思想觉悟1 天前
Android启动流程之点rc文件
android·linux·面试