README_zh.md · liangZ15/update_updateservice_5

# 升级服务组件<a name="ZH-CN_TOPIC_0000001102254666"></a>

-   [简介](#section184mcpsimp)
-   [目录](#section193mcpsimp)
-   [说明](#section208mcpsimp)
    -   [JS接口说明](#section210mcpsimp)
    -   [使用说明](#section253mcpsimp)

-   [相关仓](#section366mcpsimp)

## 简介<a name="section184mcpsimp"></a>

升级服务组件是一个SA\(System Ability\),  由OHOS 的init 进程负责启动。

升级服务器引擎主要功能包括：

1、查找可用的升级包

2、下载升级包

3、设置/获取升级策略

4、触发升级

## 目录<a name="section193mcpsimp"></a>

```
base/update/updateservice  # 升级服务代码仓目录
├── interfaces             # 升级客户端接口目录
│   ├── kits               # 对外接口封装目录
│   │   └── js             # 提供给升级客户端应用的JS 接口目录
│   └── inner_api          # SA 接口定义和封装目录
├── frameworks             # 部件无独立进程的实现
│   └── js                 # JS API的实现
│       └── napi           # napi代码实现
│           └── client     # 升级客户端napi 接口目录
├── services               # 独立进程的实现
│   ├── callback           # 提供给升级客户端应用的callback接口目录
│   └── engine             # 升级客户端引擎服务目录
│       ├── etc            # 升级客户端引擎rc配置文件目录
│       ├── include        # 升级客户端引擎头文件目录
│       ├── sa_profile     # SA 配置文件目录
│       └── src            # 升级客户端引擎源码目录
├── test                   # 测试代码目录
│   ├── unittest           # 升级客户端UT代码目录
│   └── fuzztest           # 升级客户端FT代码目录
├── BUILD.gn               # 编译入口
└── bundle.json            # 部件描述文件
```

## 说明<a name="section208mcpsimp"></a>

### JS接口说明<a name="section210mcpsimp"></a>

<a name="table212mcpsimp"></a>
<table><tbody><tr id="row217mcpsimp"><td class="cellrowborder" valign="top" width="52%"><a name="p219mcpsimp"></a><a name="p219mcpsimp"></a><a name="b220mcpsimp"></a><a name="b220mcpsimp"></a>接口
</td>
<td class="cellrowborder" valign="top" width="48%"><a name="p222mcpsimp"></a><a name="p222mcpsimp"></a>说明
</td>
</tr>
<tr id="row223mcpsimp"><td class="cellrowborder" valign="top" width="52%"><a name="p16387178102716"></a><a name="p16387178102716"></a>checkNewVersion
</td>
<td class="cellrowborder" valign="top" width="48%"><a name="p227mcpsimp"></a><a name="p227mcpsimp"></a>检查是否有可用的升级包版本
</td>
</tr>
<tr id="row228mcpsimp"><td class="cellrowborder" valign="top" width="52%"><a name="p1884710150275"></a><a name="p1884710150275"></a>download()
</td>
<td class="cellrowborder" valign="top" width="48%"><a name="p232mcpsimp"></a><a name="p232mcpsimp"></a>下载升级包
</td>
</tr>
<tr id="row233mcpsimp"><td class="cellrowborder" valign="top" width="52%"><a name="p7326722162717"></a><a name="p7326722162717"></a>upgrade()
</td>
<td class="cellrowborder" valign="top" width="48%"><a name="p237mcpsimp"></a><a name="p237mcpsimp"></a>将升级命令写入到misc分区，最终调用reboot命令，进入到updater 子系统中。
</td>
</tr>
<tr id="row238mcpsimp"><td class="cellrowborder" valign="top" width="52%"><a name="p4981103002720"></a><a name="p4981103002720"></a>getNewVersionInfo()
</td>
<td class="cellrowborder" valign="top" width="48%"><a name="p242mcpsimp"></a><a name="p242mcpsimp"></a>升级完成后，获取升级后的版本信息
</td>
</tr>
<tr id="row243mcpsimp"><td class="cellrowborder" valign="top" width="52%"><a name="p568117524271"></a><a name="p568117524271"></a>setUpdatePolicy
</td>
<td class="cellrowborder" valign="top" width="48%"><a name="p247mcpsimp"></a><a name="p247mcpsimp"></a>设置升级策略
</td>
</tr>
<tr id="row248mcpsimp"><td class="cellrowborder" valign="top" width="52%"><a name="p19534844192712"></a><a name="p19534844192712"></a>getUpdatePolicy
</td>
<td class="cellrowborder" valign="top" width="48%"><a name="p252mcpsimp"></a><a name="p252mcpsimp"></a>获取升级策略
</td>
</tr>
</tbody>
</table>

### 使用说明<a name="section253mcpsimp"></a>

1，导入updateclient lib

```
import client from 'libupdateclient.z.so'
```

2，获取update对象

```
let updater = client.getUpdater('OTA');
```

3，获取新版本信息

```
updater.getNewVersionInfo(info => {
	info "新版本信息"
});
```

4，检查新版本

```
updater.checkNewVersion(info => {
	info "新版本信息"
});
```

5，下载新版本，并监听下载进程

```
updater.download();
updater.on("downloadProgress", progress => {
	progress "下载进度信息"
});
```

6，启动升级

```
updater.upgrade();
updater.on("upgradeProgress", progress => {
	progress "升级进度信息"
});
```

7，设置升级策略

```
updater.setUpdatePolicy(result => {
	result "设置升级策略结果"
});
```

8，查看升级策略

```
updater.getUpdatePolicy(policy => {
	policy "升级策略"
});
```

## 相关仓<a name="section366mcpsimp"></a>

升级子系统

[update\_app](https://gitee.com/openharmony/update_app)

**update\_updateservice**

[update\_updater](https://gitee.com/openharmony/update_updater)

liangZ15/update_updateservice_5

简介

发行版

贡献者

近期动态

liangZ15/update_updateservice_5 .gitee-modal { width: 500px !important; }

简介

发行版

贡献者

近期动态

搜索帮助

liangZ15/update_updateservice_5