Android UpdateEngine模块流程（含序列图）-腾讯云开发者社区-腾讯云 (2024)

//以下是简单的demo app截取代码private String[] mUpdateHeader = null;private UpdateEngine mUpdateEngine = null;//创建对象mUpdateEngine = new UpdateEngine();File file = new File(filePath); //升级包文件String fileName = file.getName();PayloadSpec payloadSpec = getUpdateHeader(file);

final long size = payloadSpec.getSize();final long offset = payloadSpec.getOffset();final String url = payloadSpec.getUrl();List<String> specList = payloadSpec.getProperties();mUpdateHeader = specList.toArray(new String[specList.size()]);//bind绑定mUpdateEngine.bind(new UpdateEngineCallback() { //重写onStatusUpdate接口 @Override public void onStatusUpdate(int aStatus, float aPercent) { float iaPercent = aPercent * 100; miUpdateProgress = Math.round(iaPercent); LU.w(tag, "onStatusUpdate() aStatus== " + aStatus + " iaPercent==" + iaPercent + " " + miUpdateProgress); sendMessage(UPDATE_BEING, aStatus); } //重写onPayloadApplicationComplete接口 @Override public void onPayloadApplicationComplete(int errCode) { LU.w(tag, "onPayloadApplicationComplete() errCode== " + errCode); sendTimeMessage(UPDATE_RESULT, errCode); }});//调用applyPayload，传入升级需要的参数mUpdateEngine.applyPayload(url, offset, size, mUpdateHeader);

private static final String UPDATE_ENGINE_SERVICE = "android.os.UpdateEngineService";//构造函数public UpdateEngine() { //获取到UpdateEngine Service mUpdateEngine = IUpdateEngine.Stub.asInterface( ServiceManager.getService(UPDATE_ENGINE_SERVICE));}

public void applyPayload(String url, long offset, long size, String[] headerKeyValuePairs) { try { mUpdateEngine.applyPayload(url, offset, size, headerKeyValuePairs); } catch (RemoteException e) { throw e.rethrowFromSystemServer(); }}

//frameworks/base/core/java/android/os/UpdateEngine.java //UpdateEngineCallback在UpdateEngineCallback.java中 //APP应用调用方式参考packages/apps/Car/SystemUpdater/src/com/android/car/systemupdater/UpdateLayoutFragment.java public boolean bind(final UpdateEngineCallback callback, final Handler handler) { synchronized (mUpdateEngineCallbackLock) { //Binder机制，对应到server端是system/update_engine/binder_service_android.cc mUpdateEngineCallback = new IUpdateEngineCallback.Stub() { @Override public void onStatusUpdate(final int status, final float percent) { if (handler != null) { handler.post(new Runnable() { @Override public void run() { callback.onStatusUpdate(status, percent); } }); } else { callback.onStatusUpdate(status, percent); } }

 @Override public void onPayloadApplicationComplete(final int errorCode) { if (handler != null) { handler.post(new Runnable() { @Override public void run() { callback.onPayloadApplicationComplete(errorCode); } }); } else { callback.onPayloadApplicationComplete(errorCode); } } }; try { //mUpdateEngineCallback注册到BinderUpdateEngineAndroidService通过这个bind回调通知 return mUpdateEngine.bind(mUpdateEngineCallback); } catch (RemoteException e) { throw e.rethrowFromSystemServer(); } } }

service update_engine /system/bin/update_engine --logtostderr --logtofile --foreground class late_start user root group root system wakelock inet cache media_rw writepid /dev/cpuset/system-background/tasks disabledon property:ro.boot.slot_suffix=* enable update_engine

cc_binary { name: "update_engine", defaults: [ "ue_defaults", "libupdate_engine_android_exports", ], static_libs: ["libupdate_engine_android"], required: ["cacerts_google"], srcs: ["main.cc"], init_rc: ["update_engine.rc"],}.....

adb pull /data/misc/update_engine_logadb pull /data/misc/update_engine/

int main(int argc, char** argv) { //升级日志获取 //adb pull /data/misc/update_engine_log //adb pull /data/misc/update_engine/ DEFINE_bool(logtofile, false, "Write logs to a file in log_dir."); DEFINE_bool(logtostderr, false, "Write logs to stderr instead of to a file in log_dir."); DEFINE_bool(foreground, false, "Don't daemon()ize; run in foreground.");

 chromeos_update_engine::Terminator::Init(); brillo::FlagHelper::Init(argc, argv, "A/B Update Engine"); // We have two logging flags "--logtostderr" and "--logtofile"; and the logic // to choose the logging destination is: // 1. --logtostderr --logtofile -> logs to both // 2. --logtostderr -> logs to system debug // 3. --logtofile or no flags -> logs to file bool log_to_system = FLAGS_logtostderr; bool log_to_file = FLAGS_logtofile || !FLAGS_logtostderr; chromeos_update_engine::SetupLogging(log_to_system, log_to_file);

 if (!FLAGS_foreground) PLOG_IF(FATAL, daemon(0, 0) == 1) << "daemon() failed"; LOG(INFO) << "A/B Update Engine starting"; ...... chromeos_update_engine::UpdateEngineDaemon update_engine_daemon; //实际实现逻辑在父类daemon.cc的run函数 int exit_code = update_engine_daemon.Run(); chromeos_update_engine::Subprocess::Get().FlushBufferedLogsAtExit(); LOG(INFO) << "A/B Update Engine terminating with exit code " << exit_code; return exit_code;}

//system/update_engine/daemon.hclass UpdateEngineDaemon : public brillo::Daemon { ....}//external/libbrillo/brillo/daemons/daemon.ccint Daemon::Run() { //调用到UpdateEngineDaemon的OnInit int exit_code = OnInit(); if (exit_code != EX_OK) return exit_code; message_loop_.PostTask( base::Bind(&Daemon::OnEventLoopStartedTask, base::Unretained(this))); message_loop_.Run(); OnShutdown(&exit_code_); ...... return exit_code_;}

int UpdateEngineDaemon::OnInit() { // Register the |subprocess_| singleton with this Daemon as the signal // handler. subprocess_.Init(this); //调用到父类的OnInit int exit_code = Daemon::OnInit();

 if (exit_code != EX_OK) return exit_code; ...... //创建DaemonStateAndroid对象 DaemonStateAndroid* daemon_state_android = new DaemonStateAndroid(); daemon_state_.reset(daemon_state_android); //初始化 //1.CreateBootControl //2.CreateHardware //3.new Prefs() //4.new CertificateChecker //5.new UpdateAttempterAndroid，构造函数将bootcontrol，hardware，prefs传递给该类 LOG_IF(ERROR, !daemon_state_android->Initialize()) << "Failed to initialize system state.";#endif // USE_OMAHA

#if USE_BINDER // Create the Binder Service.#if USE_OMAHA binder_service_ = new BinderUpdateEngineBrilloService{real_system_state};#else // !USE_OMAHA//创建BinderUpdateEngineAndroidService对象 binder_service_ = new BinderUpdateEngineAndroidService{ daemon_state_android->service_delegate()};#endif // USE_OMAHA auto binder_wrapper = android::BinderWrapper::Get(); //将BinderUpdateEngineBrilloService注册到serviceManager中 if (!binder_wrapper->RegisterService(binder_service_->ServiceName(), binder_service_)) { LOG(ERROR) << "Failed to register binder service."; } //将该对象传递给DaemonStateAndroid对象 daemon_state_->AddObserver(binder_service_.get());#endif // USE_BINDER#if USE_DBUS // Create the DBus service. dbus_adaptor_.reset(new UpdateEngineAdaptor(real_system_state)); daemon_state_->AddObserver(dbus_adaptor_.get()); dbus_adaptor_->RegisterAsync(base::Bind(&UpdateEngineDaemon::OnDBusRegistered, base::Unretained(this))); LOG(INFO) << "Waiting for DBus object to be registered.";#else // !USE_DBUS //主要调用update_attempter_->Init()初始化方法 daemon_state_->StartUpdater();#endif // USE_DBUS return EX_OK;}

usb_ota_update.zip目录2021/12/06 14:55 <DIR> .2021/12/06 14:55 <DIR> ..2021/12/06 14:54 <DIR> META-INF2009/01/01 00:00 891,093,819 payload.bin2009/01/01 00:00 155 payload_properties.txt

$ cat ../../../payload_properties.txt //payload.bin升级包数据FILE_HASH=Kw0egs8dY9Qm1sULkpkAPF+0PiKx14Uo0fHGZO3vNAk=FILE_SIZE=2515281637//压缩后的 manifest 数据METADATA_HASH=z+5Qz8UIBrhCtMDgo+5IG4/rQqFUqmN/FMFyIWhaIEU=METADATA_SIZE=179557$ ls -l payload.bin -rw-r--r-- 1 wsun17 domain users 2515281637 Jan 1 2009 payload.bin //文件大小对应$ sha256sum payload.bin | awk '{print $1}' | xxd -r -ps | base64Kw0egs8dY9Qm1sULkpkAPF+0PiKx14Uo0fHGZO3vNAk= //计算后的文件hash值对应$ dd if=payload.bin bs=1 count=179557 2>/dev/null | sha256sum | awk '{print $1}' | xxd -r -ps | base64 //计算后的metadata hash值对应z+5Qz8UIBrhCtMDgo+5IG4/rQqFUqmN/FMFyIWhaIEU=

adb rootadb pull /data/misc/update_engine_logadb pull /data/misc/update_engine/

:/data/misc/update_engine/prefs # ls -thltotal 38K-rw------- 1 root root 1 2021-01-01 00:11 total-bytes-downloaded-rw------- 1 root root 17 2021-01-01 00:11 system-updated-marker-rw------- 1 root root 1 2021-01-01 00:11 delta-update-failures-rw------- 1 root root 36 2021-01-01 00:11 update-completed-on-boot-id-rw------- 1 root root 4 2021-01-01 00:11 post-install-succeeded-rw------- 1 root root 4 2021-01-01 00:09 verity-written-rw------- 1 root root 1 2021-01-01 00:08 update-state-next-data-length-rw------- 1 root root 9 2021-01-01 00:08 update-state-next-data-offset-rw------- 1 root root 4 2021-01-01 00:08 update-state-next-operation-rw------- 1 root root 112 2021-01-01 00:08 update-state-sha-256-context-rw------- 1 root root 264 2021-01-01 00:08 update-state-signature-blob-rw------- 1 root root 112 2021-01-01 00:08 update-state-signed-sha-256-context-rw------- 1 root root 6 2021-01-01 00:02 manifest-metadata-size-rw------- 1 root root 3 2021-01-01 00:02 manifest-signature-size-rw------- 1 root root 4 2021-01-01 00:02 dynamic-partition-metadata-updated-rw------- 1 root root 1 2021-01-01 00:02 resumed-update-failures-rw------- 1 root root 88 2021-01-01 00:02 update-check-response-hash-rw------- 1 root root 36 1970-01-01 08:00 boot-id-rw------- 1 root root 24 1970-01-01 08:00 previous-version:/data/misc/update_engine/prefs # cat boot-ide2ecfeb4-d097-449c-8c7b-e8aee5067cc6:/data/misc/update_engine/prefs # cat previous-versioneng.user.20211201.031118:/data/misc/update_engine/prefs # cat update-check-response-hashLBhFc9jN99sOu9/VKy7COfkBXtXzlDt5fHdx1kQyU3c=vsNI/ZuKzDY0uOuXZIOjr42UHrzJ86isJSEtAwlFf9k=

//android/system/update_engine/common/error_code.h// Action exit codes.enum class ErrorCode : int { kSuccess = 0, //升级成功 kError = 1, //升级失败 kOmahaRequestError = 2, //请求action错误（action机制用于控制升级每个步骤） kOmahaResponseHandlerError = 3, //返回handler action错误 kFilesystemCopierError = 4, //文件系统拷贝错误 kPostinstallRunnerError = 5, //预编译运行步骤错误（PostinstallRunner是一个升级步骤） kPayloadMismatchedType = 6, //NOT NEED kInstallDeviceOpenError = 7, //安装设备打开错误 kKernelDeviceOpenError = 8, //内核设备打开错误 kDownloadTransferError = 9, //下载传输错误 kPayloadHashMismatchError = 10, //升级包hash未匹配错误 kPayloadSizeMismatchError = 11, //升级包size未匹配错误 kDownloadPayloadVerificationError = 12, //下载过程升级包校验错误 kDownloadNewPartitionInfoError = 13, //下载过程新分区信息错误 kDownloadWriteError = 14, //下载过程数据写入错误 kNewRootfsVerificationError = 15, //升级分区hash校验失败 kNewKernelVerificationError = 16, //升级kernel校验失败 kSignedDeltaPayloadExpectedError = 17, //NOT NEED kDownloadPayloadPubKeyVerificationError = 18, //下载过程升级包public key公钥校验错误 kPostinstallBootedFromFirmwareB = 19, //NOT NEED kDownloadStateInitializationError = 20, //下载状态初始化错误 kDownloadInvalidMetadataMagicString = 21, //NOT NEED kDownloadSignatureMissingInManifest = 22, //下载过程manifest缺少签名错误 kDownloadManifestParseError = 23, //下载过程manifest分析错误 kDownloadMetadataSignatureError = 24, //下载过程元数据签名错误 kDownloadMetadataSignatureVerificationError = 25, //下载过程元数据签名校验错误 kDownloadMetadataSignatureMismatch = 26, //下载过程元数据签名不匹配错误 kDownloadOperationHashVerificationError = 27, //下载过程操作hash校验错误 kDownloadOperationExecutionError = 28, //下载过程操作执行错误 kDownloadOperationHashMismatch = 29, //下载过程操作hash不匹配错误 kOmahaRequestEmptyResponseError = 30, //请求action无返回错误 kOmahaRequestXMLParseError = 31, //请求action分析xml错误 kDownloadInvalidMetadataSize = 32, //下载过程非法元数据大小 kDownloadInvalidMetadataSignature = 33, //下载过程非法元数据签名 kOmahaResponseInvalid = 34, //返回action非法错误 kOmahaUpdateIgnoredPerPolicy = 35, //NOT NEED（含义是接收已回滚版本，忽略此次升级） kOmahaUpdateDeferredPerPolicy = 36, //NOT NEED（含义是因更新策略延迟，忽略此次升级） kOmahaErrorInHTTPResponse = 37, //HTTP返回错误 kDownloadOperationHashMissingError = 38, //下载过程操作时缺失hash错误 kDownloadMetadataSignatureMissingError = 39, //下载过程元数据签名缺失错误 kOmahaUpdateDeferredForBackoff = 40, //NOT NEED（含义是忽略本次升级） kPostinstallPowerwashError = 41, //NOT NEED（回滚报错，该版本已去除版本回滚限制） kUpdateCanceledByChannelChange = 42, //通道变化升级取消 kPostinstallFirmwareRONotUpdatable = 43, //NOT NEED(需要升级固件firmware时才会取消，因为无法从FW B分区启动到FW A分区) kUnsupportedMajorPayloadVersion = 44, //获取manifest偏移量错误 kUnsupportedMinorPayloadVersion = 45, //未manifest可支持更小版本错误 kOmahaRequestXMLHasEntityDecl = 46, //请求action xml hash非法错误 kFilesystemVerifierError = 47, //文件系统校验错误（FilesystemVerifier是一个升级步骤） kUserCanceled = 48, //用户取消 kNonCriticalUpdateInOOBE = 49, //NOT NEED（Ignoring a non-critical Omaha update before OOBE completion.） kOmahaUpdateIgnoredOverCellular = 50, //NOT NEED（未设置设备策略，因此用户首选项需要覆盖是否允许通过蜂窝网络进行更新） kPayloadTimestampError = 51, //升级包时间戳错误 （payload.bin是OTA镜像打包文件） kUpdatedButNotActive = 52, //升级分区非action状态错误 kNoUpdate = 53, //无升级（There are no updates. Aborting.） kRollbackNotPossible = 54, //NOT NEED kFirstActiveOmahaPingSentPersistenceError = 55, //NOT NEED（用于旧设备的Omaha校验） kVerityCalculationError = 56, //校验计算错误（在FilesystemVerifier步骤中进行分区校验时）