1# 升级包安装组件<a name="ZH-CN_TOPIC_0000001148614629"></a> 2 3- [简介](#section184mcpsimp) 4- [目录](#section198mcpsimp) 5- [说明](#section218mcpsimp) 6 - [使用说明](#section220mcpsimp) 7 8- [相关仓](#section247mcpsimp) 9 10## 简介<a name="section184mcpsimp"></a> 11 12升级包安装组件运行在updater分区，其功能主要包括读取misc分区信息获取升级包状态，对升级包进行校验，确保升级包合法有效；然后从升级包中解析出升级的可执行程序，创建子进程并启动升级程序。具体升级的动作由升级脚本控制。 13 14更多升级子系统相关概念，请参考：[升级子系统](https://gitee.com/openharmony/docs/blob/master/zh-cn/readme/%E5%8D%87%E7%BA%A7%E5%AD%90%E7%B3%BB%E7%BB%9F.md) 15 16**图 1** 升级子系统架构图 17 18 19 20## 目录<a name="section198mcpsimp"></a> 21 22``` 23base/update/updater/ 24├── resources # 升级子系统用户界面图片资源目录 25├── services # 组件服务层代码目录 26│ ├── applypatch # 升级包数据更新代码目录 27│ ├── diffpatch # 差分还原代码目录 28│ ├── etc # 启动相关配置文件目录 29│ ├── flashd # flashd模式镜像写入和升级功代码目录 30│ ├── fs_manager # 文件系统和分区管理代码目录 31│ ├── hdi # 硬件相关接口定义 32│ ├── include # 升级子系统头文件目录 33│ ├── log # 升级子系统日志模块目录 34│ ├── package # 升级包管理模块目录 35│ ├── ptable_parse # 分区表解析代码目录 36│ ├── script # 升级脚本管理目录 37│ ├── ui # 升级ui界面代码目录 38│ └── updater_binary # 升级可执行程序目录 39├── interfaces 40│ └── kits # 对外模块接口定义 41└── utils # 升级子系统通用代码目录 42 └── include # 升级子系统通用函数头文件目录 43``` 44 45## 说明<a name="section218mcpsimp"></a> 46 47### 使用说明<a name="section220mcpsimp"></a> 48 49升级包安装组件运行在updater分区里，需要如下的操作 50 511、创建updater分区 52 53updater是一个独立的分区，分区大小建议不小于20MB。updater分区镜像是ext4 格式文件系统。确保系统内核ext4 文件系统的config 是打开状态。 54 552、创建misc分区 56 57misc 分区中存储了升级子系统在升级过程中需要的元数据\(metadata\)，如升级命令，掉电续传记录等。 misc 分区的大小约1MB，是一个裸分区，无需制作文件系统， 升级子系统直接访问。 58 593、分区配置表 60 61升级包安装组件在运行过程中，需要通过分区配置表操作分区。默认的分区配置表文件名是fstab.updater，在编译的时候，打包到升级包安装组件中。 62 634、升级包安装组件启动 64 65updater分区的init 进程有单独的配置文件 init.cfg，升级包安装进程启动配置在该文件中。 66 675、升级包安装组件编译 68 69a、在build/subsystem\_config.json文件添加配置。 70 71如下： 72 73``` 74"updater": { 75"project": "hmf/updater", 76"path": "base/update/updater", 77"name": "updater", 78"dir": "base/update" 79}, 80``` 81 82b、 产品中添加需要编译的组件 83 84以Hi3516DV300为例，在productdefine/common/products/Hi3516DV300.json 中添加updater： 85 86``` 87 "updater:updater":{}, 88``` 89 906、updater分区镜像编译 91 92编译配置在build仓下，build\_updater\_image.sh 脚本中，该脚本由OHOS 编译系统调用。 93 94## AB流式升级<a name="section218mcpsimp"></a> 95 96用户设备并非在data分区上总是有足够的空间用于下载OTA升级包，同时用户有时候不需要进入小系统升级来影响设备体验。为了解决这些问题，OpenHarmony中添加了对AB流式升级的更新，可以在下载数据块Chunk写入备用B分区，而无需将数据块或者升级包存储到data分区；同时不需要进入updater小系统进行升级，用户设备操作在活跃A分区，更新在备用B分区。 97 98### 关键技术<a name="section220mcpsimp"></a> 99 1001、 支持AB分区独立升级，实现无缝更新。 101 1022、 支持流式升级断点续传，在网络断开连接、用户操作暂停等操作后，重新点击下载并更新可以实现继续更新。 103 1043、 支持多种安全校验，每个数据块Chunk会带有哈希校验，更新完后会对每个镜像进行完整性校验。 105 1064、 支持异常回滚机制，确保升级失败时自动恢复到稳定分区，确保用户体验。 107 1085、 支持流式传输数据块自定义，可以根据设备data分区大小自调整。 109 110### 做包流程<a name="section220mcpsimp"></a> 111 112在AB流式升级当中，修改的重点是在原AB差分或者全量升级包的基础上，对大于本文档数据大小要求的new和diff操作要进行更小的切片，并按照TLV格式把差分依赖文件都封装到update.bin文件中 113 1141、 切割内容大于45KB的diff/new 115 116输入参数:pkgdiff、new命令 117 118输出结果:对于pkgdiff命令尝试生成diff文件，如果diff文件大于45KB，就把pkgdiff命令分成多个pkgdiff，直到每个pkgdiff命令的diff文件大小都小于45KB。new命令直接判断block的内容大小，不满足大小的，就分割成多个new命令 119 1202、计算img总块除去action列表中操作的块 121 122输入参数：action列表中所有操作过的块，img总块 123 124输出参数：两者补集，即将需要copy的块进行升序排序，连续的组成集合，按照原有new的格式进行组合成copy命令 125 1263、根据TLV格式封装action及diff等内容到update.bin 127 128输入参数:transfer.list、new.dat、patch.dat 129 130输出结果:将transfer.list每一行封装成一个chunk，依赖的内容在new.dat和patch.dat中查找，并按TLV格式生成update.bin 131 132## 相关仓<a name="section247mcpsimp"></a> 133 134[升级子系统](https://gitee.com/openharmony/docs/blob/master/zh-cn/readme/%E5%8D%87%E7%BA%A7%E5%AD%90%E7%B3%BB%E7%BB%9F.md) 135 136[**update\_updater**](https://gitee.com/openharmony/update_updater) 137 138[build](https://gitee.com/openharmony/build) 139 140[productdefine\_common](https://gitee.com/openharmony/productdefine_common) 141