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![](figures/Openharmony-updater-升级子系统架构图.png)
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## 相关仓<a name="section247mcpsimp"></a>
95
96[升级子系统](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)
97
98[**update\_updater**](https://gitee.com/openharmony/update_updater)
99
100[build](https://gitee.com/openharmony/build)
101
102[productdefine\_common](https://gitee.com/openharmony/productdefine_common)
103
104