less than 1 minute read

Android A/B升级又称静默升级,它是一种在系统运行过程中进行的升级功能。为了减小系统运行负荷,整个升级过程会保持在一个较低的IO状态,所以升级时间比recovery升级明显要长。

1. 升级方法

当AB系统升级时,有两种方式来调用updateengine,来实现升级:

  • 一种方法是直接执行shell命令,调用update_engine_client,带参数来实现升级。界面不会显示,可通过打印日志观察进度adb logcat -s update_engine
//解压升级包
adb shell
update_engine_client --payload=file:///storage/5F49-FB9D/socupdate8g/payload.bin --update --headers="FILE_HASH=YP7Z1bFDv6O8C5LTWZ20JxTljXyoVitlCX27TBTyVDM=
FILE_SIZE=967460335
METADATA_HASH=1gpTz/Q7T1ysTu6suP8N2KVOfa+vKEdnJGnPsKcPiXw=
METADATA_SIZE=75378"
  • 另一种方式是应用层直接调用UpdateEngine的applyPayload方法来升级,主要的核心逻辑模块是update_engine

2. 原生Demo APP

原生的升级参考示例APK(以Android Q AOSP为例):packages/apps/Car/SystemUpdater

这是Android P(9)Google提供的一个Demo APK,可以用作本地U盘测试升级

启动方式:adb shell am start com.android.car.systemupdater/.SystemUpdaterActivity

该应用大概流程逻辑:

  1. 读取U盘中的升级文件,用户点击目标升级文件
  2. 调用updateEngine传递主要参数,updateEngine的callback向用户显示升级升级进度
  3. 在升级结束之后通知powermanager重启reboot机器

3. 应用层API相关接口说明

3.1. framwork层应用接口

源代码位置:

  • framwork/base/core/java/android/os/UpdateEngine.java
  • framwork/base/core/java/android/os/UpdateEngineCallback.java

3.2. APP应用调取升级接口applyUpdate流程

(需要系统权限的App,需要系统签名,这些Api也是@SystemApi的)

  1. 创建UpdateEngineCallback的对象mUpdateEngineCallback
  2. 创建UpdateEngine的对象mUpdateEngine, 创建后服务开启
  3. 使用mUpdateEngine.bind(mUpdateEngineCallback),因为bind方法时接受的callback对象,而我们创建的类继承了callback,传入当前类的对象即可
  4. 调用applyPayload(String url,long offset,long size,String[] headerKeyValuePairs)方法具体执行升级
  5. 在重写的onStatusUpdate(int status, float percent)方法中根据拿到的状态执行进度逻辑
  6. 在重写的onPayloadApplicationComplete(int errorCode)方法中执行升级完成后的逻辑

4. update_engine模块概述

update_engine是A/B升级的核心逻辑,用于执行下载和升级,路径:android/system/update_engine/

update_engine_client:update_engine_client是客户端进程,用来解析命令行的各种操作(suspend/resume/cancel/reset_status/follow/update),并将这些操作和参数通过binder机制,转发为对服务端进程UpdateEngineService相应操作的调用

4.1. update engine核心Action流程

update_engine升级会依次执行四个升级动作:InstallAction,DownloadAction,FilesystemVerfierAction,PostinstallRunnerAction

启动DownloadAction和PostinstallRunnerAction耗时最长

  1. DownloadAction是执行具体的升级拷贝动作,将镜像文件中的内容拷贝到指定分区,这一步的时间不容易缩减。

  2. PostinstallRunnerAction是根据post install script进行预编译工作,将target_slot标记为active。

在device.mk配置是:

#调试工具
PRODUCT_PACKAGES_DEBUG += \
    update_engine_client

# A/B OTA dexopt package升级脚本
PRODUCT_PACKAGES += otapreopt_script

#将这部分注释掉,可以减少PostinstallRunnerAction步骤的耗时(需谨慎修改)
# A/B OTA dexopt update_engine hookup
AB_OTA_POSTINSTALL_CONFIG += \
    RUN_POSTINSTALL_system=true \
    POSTINSTALL_PATH_system=system/bin/otapreopt_script \
    FILESYSTEM_TYPE_system=ext4 \
    POSTINSTALL_OPTIONAL_system=true

5. 参考