Skip to content

D
Docs

OpenHarmony / Docs
大约 2 年 前同步成功

通知 161
Star 293
Fork 28
D
Docs
提交 a955c19e 编写于 作者: L liangZ15
浏览文件
操作

Signed-off-by: liangZ15 <lihongliang20@huawei.com>

上级 80e462e9
隐藏空白更改
内联 并排
Showing with 58 addition and 109 deletion
zh-cn/application-dev/reference/apis/js-apis-update.md
浏览文件 @ a955c19e
...@@ -143,7 +143,7 @@ checkNewVersion(): Promise\<CheckResult> ...@@ -143,7 +143,7 @@ checkNewVersion(): Promise\<CheckResult>
| 类型 | 说明 | | 类型 | 说明 |
| ---------------------------------------- | ---------------- | | ---------------------------------------- | ---------------- |
| Promise\<[CheckResult](#checkResult)> | Promise函数回调返回检测结果 | | Promise\<[CheckResult](#checkResult)> | Promise函数返回检测结果 |
**示例:** **示例:**
...@@ -153,7 +153,7 @@ updater.checkNewVersion().then(result => { ...@@ -153,7 +153,7 @@ updater.checkNewVersion().then(result => {
// 版本摘要信息 // 版本摘要信息
console.log("checkNewVersion versionDigestInfo " + result.newVersionInfo.versionDigestInfo); console.log("checkNewVersion versionDigestInfo " + result.newVersionInfo.versionDigestInfo);
}).catch(err => { }).catch(err => {
console.log("checkNewVersion promise error $JSON.stringify(err)); console.log("checkNewVersion promise error $JSON.stringify(err)");
}); });
``` ```
...@@ -198,8 +198,8 @@ getNewVersionInfo(): Promise\<NewVersionInfo> ...@@ -198,8 +198,8 @@ getNewVersionInfo(): Promise\<NewVersionInfo>
``` ```
updater.getNewVersionInfo().then(info => { updater.getNewVersionInfo().then(info => {
console.log(`info versionName = ` + info.versionComponent[0].displayVersion); console.log(`info versionName = ` + info.versionComponents[0].displayVersion);
console.log(`info versionCode = ` + info.versionComponent[0].innerVersion); console.log(`info versionCode = ` + info.versionComponents[0].innerVersion);
}).catch(err => { }).catch(err => {
console.log("getNewVersionInfo promise error $JSON.stringify(err)); console.log("getNewVersionInfo promise error $JSON.stringify(err));
}); });
...@@ -251,7 +251,7 @@ updater.getCurrentVersionInfo().then(info => { ...@@ -251,7 +251,7 @@ updater.getCurrentVersionInfo().then(info => {
console.log(`info deviceName = ` + info.deviceName); console.log(`info deviceName = ` + info.deviceName);
console.log(`info displayVersion = ` + info.versionComponents[0].displayVersion); console.log(`info displayVersion = ` + info.versionComponents[0].displayVersion);
}).catch(err => { }).catch(err => {
console.log("getNewVersionInfo promise error $JSON.stringify(err)); console.log("getCurrentVersionInfo promise error $JSON.stringify(err)");
}); });
``` ```
...@@ -297,7 +297,7 @@ getTaskInfo(): Promise\<TaskInfo> ...@@ -297,7 +297,7 @@ getTaskInfo(): Promise\<TaskInfo>
updater.getTaskInfo().then(value => { updater.getTaskInfo().then(value => {
console.log(`getTaskInfo isexistTask= ` + info.existTask); console.log(`getTaskInfo isexistTask= ` + info.existTask);
}).catch(err => { }).catch(err => {
console.log("getTaskInfo promise error $JSON.stringify(err)); console.log("getTaskInfo promise error $JSON.stringify(err)");
}); });
``` ```
...@@ -327,7 +327,7 @@ var versionDigestInfo = { ...@@ -327,7 +327,7 @@ var versionDigestInfo = {
// 下载选项 // 下载选项
var downloadOptions = { var downloadOptions = {
allowNetwork: NeyType.CELLULAR_AND_WIFI, // 允许所有网络下载 allowNetwork: NetType.CELLULAR_AND_WIFI, // 允许所有网络下载
order: Order.DOWNLOAD // 下载 order: Order.DOWNLOAD // 下载
} }
updater.download(versionDigestInfo, downloadOptions, (err) => { updater.download(versionDigestInfo, downloadOptions, (err) => {
...@@ -366,7 +366,7 @@ var versionDigestInfo = { ...@@ -366,7 +366,7 @@ var versionDigestInfo = {
// 下载选项 // 下载选项
var downloadOptions = { var downloadOptions = {
allowNetwork: NeyType.CELLULAR_AND_WIFI, // 允许所有网络下载 allowNetwork: NetType.CELLULAR_AND_WIFI, // 允许所有网络下载
order: Order.DOWNLOAD // 下载 order: Order.DOWNLOAD // 下载
} }
updater.download(versionDigestInfo, downloadOptions).then(void => { updater.download(versionDigestInfo, downloadOptions).then(void => {
...@@ -402,7 +402,7 @@ var versionDigestInfo = { ...@@ -402,7 +402,7 @@ var versionDigestInfo = {
// 恢复下载选项 // 恢复下载选项
var resumeDownloadOptions = { var resumeDownloadOptions = {
allowNetwork: NeyType.CELLULAR_AND_WIFI, // 允许所有网络下载 allowNetwork: NetType.CELLULAR_AND_WIFI, // 允许所有网络下载
} }
updater.resumeDownload(versionDigestInfo, resumeDownloadOptions, (err) => { updater.resumeDownload(versionDigestInfo, resumeDownloadOptions, (err) => {
console.log(`resumeDownload error $JSON.stringify(err)`); console.log(`resumeDownload error $JSON.stringify(err)`);
...@@ -440,7 +440,7 @@ var versionDigestInfo = { ...@@ -440,7 +440,7 @@ var versionDigestInfo = {
// 恢复下载选项 // 恢复下载选项
var resumeDownloadOptions = { var resumeDownloadOptions = {
allowNetwork: NeyType.CELLULAR_AND_WIFI, // 允许所有网络下载 allowNetwork: NetType.CELLULAR_AND_WIFI, // 允许所有网络下载
} }
updater.resumeDownload(versionDigestInfo, resumeDownloadOptions).then(value => { updater.resumeDownload(versionDigestInfo, resumeDownloadOptions).then(value => {
console.log(`resumeDownload start`); console.log(`resumeDownload start`);
...@@ -463,7 +463,7 @@ pauseDownload(versionDigestInfo: VersionDigestInfo, pauseDownloadOptions: PauseD ...@@ -463,7 +463,7 @@ pauseDownload(versionDigestInfo: VersionDigestInfo, pauseDownloadOptions: PauseD
| -------- | ---------------------------------------- | ---- | --------- | | -------- | ---------------------------------------- | ---- | --------- |
| versionDigestInfo | [VersionDigestInfo](#versionDigestInfo) | 是 | 版本摘要信息 | | versionDigestInfo | [VersionDigestInfo](#versionDigestInfo) | 是 | 版本摘要信息 |
| pauseDownloadOptions | [PauseDownloadOptions](#pauseDownloadOptions) | 是 | 暂停下载选项 | | pauseDownloadOptions | [PauseDownloadOptions](#pauseDownloadOptions) | 是 | 暂停下载选项 |
| callback | AsyncCallback<void> | 是 | 下载执行回调 | | callback | AsyncCallback<void> | 是 | 执行回调 |
**示例：** **示例：**
...@@ -559,7 +559,7 @@ updater.upgrade(versionDigestInfo, upgradeOptions, (err) => { ...@@ -559,7 +559,7 @@ updater.upgrade(versionDigestInfo, upgradeOptions, (err) => {
upgrade(versionDigestInfo: VersionDigestInfo, upgradeOptions: UpgradeOptions): Promise\<void> upgrade(versionDigestInfo: VersionDigestInfo, upgradeOptions: UpgradeOptions): Promise\<void>
恢复下载新版本，使用promise方式作为异步方法。 升级新版本，使用promise方式作为异步方法。
**系统能力**：SystemCapability.Update.UpdateService **系统能力**：SystemCapability.Update.UpdateService
...@@ -659,7 +659,7 @@ var versionDigestInfo = { ...@@ -659,7 +659,7 @@ var versionDigestInfo = {
// 清除选项 // 清除选项
var clearOptions = { var clearOptions = {
status: status: UpgradeStatus.UPGRADE_FAIL, status: UpgradeStatus.UPGRADE_FAIL,
} }
updater.clearError(versionDigestInfo, clearOptions).then(value => { updater.clearError(versionDigestInfo, clearOptions).then(value => {
console.log(`clearError success`); console.log(`clearError success`);
...@@ -712,7 +712,7 @@ updater.getUpgradePolicy().then(policy => { ...@@ -712,7 +712,7 @@ updater.getUpgradePolicy().then(policy => {
console.log(`policy downloadStrategy = ` + policy.downloadStrategy); console.log(`policy downloadStrategy = ` + policy.downloadStrategy);
console.log(`policy autoUpgradeStrategy = ` + policy.autoUpgradeStrategy); console.log(`policy autoUpgradeStrategy = ` + policy.autoUpgradeStrategy);
}).catch(err => { }).catch(err => {
console.log("getUpgradePolicy promise error $JSON.stringify(err)`); console.log(`getUpgradePolicy promise error $JSON.stringify(err)`);
}); });
``` ```
...@@ -737,9 +737,9 @@ setUpgradePolicy(policy: UpgradePolicy, callback: AsyncCallback\<number>): void ...@@ -737,9 +737,9 @@ setUpgradePolicy(policy: UpgradePolicy, callback: AsyncCallback\<number>): void
let policy = { let policy = {
downloadStrategy: false, downloadStrategy: false,
autoUpgradeStrategy: false, autoUpgradeStrategy: false,
autoUpgradeInterval: [ 2, 3 ], autoUpgradeInterval: [ 120, 240 ], // 自动升级时间段,用分钟表示
} }
updater.setUpgradePolicy(clearOptions, (value, err) => { updater.setUpgradePolicy(policy, (value, err) => {
console.log(`setUpgradePolicy result: ` + value?); console.log(`setUpgradePolicy result: ` + value?);
}); });
``` ```
...@@ -775,7 +775,7 @@ let policy = { ...@@ -775,7 +775,7 @@ let policy = {
updater.setUpdatePolicy(policy).then(result => updater.setUpdatePolicy(policy).then(result =>
console.log("setUpdatePolicy ", result) console.log("setUpdatePolicy ", result)
).catch(err => { ).catch(err => {
console.log("setUpdatePolicy promise error $JSON.stringify(err)`); console.log(`setUpdatePolicy promise error $JSON.stringify(err)`);
}); });
``` ```
...@@ -839,7 +839,7 @@ factoryReset(callback: AsyncCallback\<void>): void ...@@ -839,7 +839,7 @@ factoryReset(callback: AsyncCallback\<void>): void
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | ---------------------------------------- | ---- | --------- | | -------- | ---------------------------------------- | ---- | --------- |
| callback | AsyncCallback\<void> | 是 | 回调返回新版本信息 | | callback | AsyncCallback\<void> | 是 | 回调结果 |
**示例：** **示例：**
...@@ -895,11 +895,11 @@ verifyUpgradePackage(upgradeFile: UpgradeFile, certsFile: string, callback: Asyn ...@@ -895,11 +895,11 @@ verifyUpgradePackage(upgradeFile: UpgradeFile, certsFile: string, callback: Asyn
``` ```
var upgradeFile = { var upgradeFile = {
fileType: 1 // OTA包 fileType: ComponentType.OTA // OTA包
filePath: "path" // 本地升级包路径 filePath: "path" // 本地升级包路径
} }
localUpdater.verifyUpgradePackage(upgradeFile, "cerstFilePath", (err) => { localUpdater.verifyUpgradePackage(upgradeFile, "cerstFilePath", (err, value) => {
console.log("factoryReset error $JSON.stringify(err)"); console.log("factoryReset error $JSON.stringify(err)");
}); });
``` ```
...@@ -918,7 +918,6 @@ verifyUpgradePackage(upgradeFile: UpgradeFile, certsFile: string): Promise\<void ...@@ -918,7 +918,6 @@ verifyUpgradePackage(upgradeFile: UpgradeFile, certsFile: string): Promise\<void
| -------- | ---------------------------------------- | ---- | --------- | | -------- | ---------------------------------------- | ---- | --------- |
| upgradeFile | [UpgradeFile](#upgradeFile) | 是 | 升级文件 | | upgradeFile | [UpgradeFile](#upgradeFile) | 是 | 升级文件 |
| certsFile | string | 是 | 证书文件路径 | | certsFile | string | 是 | 证书文件路径 |
| callback | AsyncCallback\<number> | 是 | 回调校验结果 |
**返回值:** **返回值:**
...@@ -930,7 +929,7 @@ verifyUpgradePackage(upgradeFile: UpgradeFile, certsFile: string): Promise\<void ...@@ -930,7 +929,7 @@ verifyUpgradePackage(upgradeFile: UpgradeFile, certsFile: string): Promise\<void
``` ```
var upgradeFile = { var upgradeFile = {
fileType: Component.OTA // OTA包 fileType: ComponentType.OTA // OTA包
filePath: "path" // 本地升级包路径 filePath: "path" // 本地升级包路径
} }
updater.verifyUpgradePackage(upgradeFile, "cerstFilePath").then(number => { updater.verifyUpgradePackage(upgradeFile, "cerstFilePath").then(number => {
...@@ -958,7 +957,7 @@ applyNewVersion(upgradeFiles: Array<[UpgradeFile](#upgradeFile)>, callback: Asyn ...@@ -958,7 +957,7 @@ applyNewVersion(upgradeFiles: Array<[UpgradeFile](#upgradeFile)>, callback: Asyn
``` ```
var upgradeFiles = [{ var upgradeFiles = [{
fileType: Component.OTA // OTA包 fileType: ComponentType.OTA // OTA包
filePath: "path" // 本地升级包路径 filePath: "path" // 本地升级包路径
}] }]
...@@ -985,7 +984,7 @@ applyNewVersion(upgradeFiles: Array<[UpgradeFile](#upgradeFile)>): Promise\<void ...@@ -985,7 +984,7 @@ applyNewVersion(upgradeFiles: Array<[UpgradeFile](#upgradeFile)>): Promise\<void
``` ```
var upgradeFile = [{ var upgradeFile = [{
fileType: 1 // OTA包 fileType: ComponentType.OTA // OTA包
filePath: "path" // 本地升级包路径 filePath: "path" // 本地升级包路径
}] }]
updater.applyNewVersion(upgradeFiles).then(void => { updater.applyNewVersion(upgradeFiles).then(void => {
...@@ -1053,68 +1052,16 @@ function onTaskUpdate(eventInfo): void { ...@@ -1053,68 +1052,16 @@ function onTaskUpdate(eventInfo): void {
localUpdater.off(eventClassifyInfo, onTaskUpdate); localUpdater.off(eventClassifyInfo, onTaskUpdate);
``` ```
## UpdateTypes
升级类型。
**系统能力**：以下各项对应的系统能力均为:SystemCapability.Update.UpdateService
| 参数名 | 说明 |
| ----- | ----- |
| OTA | OTA升级 |
| patch | 补丁升级 |
## PackageTypes
升级包类型。
**系统能力**：以下各项对应的系统能力均为:SystemCapability.Update.UpdateService
| 参数名 | 默认值 | 说明 |
| -------------------- | ---- | ------- |
| PACKAGE_TYPE_NORMAL | 1 | 通用升级包 |
| PACKAGE_TYPE_BASE | 2 | 基础升级包 |
| PACKAGE_TYPE_CUST | 3 | 定制升级包 |
| PACKAGE_TYPE_PRELOAD | 4 | 预装升级包 |
| PACKAGE_TYPE_COTA | 5 | 参数配置升级包 |
| PACKAGE_TYPE_VERSION | 6 | 版本升级包 |
| PACKAGE_TYPE_PATCH | 7 | 补丁包 |
## InstallMode
安装模式。
**系统能力**：以下各项对应的系统能力均为:SystemCapability.Update.UpdateService
| 参数名 | 默认值 | 说明 |
| ------------------- | ---- | ---- |
| INSTALL_MODE_NORMAL | 0 | 正常升级 |
| INSTALL_MODE_NIGHT | 1 | 夜间升级 |
| INSTALL_MODE_AUTO | 2 | 自动升级 |
## NewVersionStatus
新版本检测状态。
**系统能力**：以下各项对应的系统能力均为:SystemCapability.Update.UpdateService
| 参数名 | 默认值 | 说明 |
| ------------------- | ---- | -------- |
| VERSION_STATUS_ERR | -1 | 检测版本时出错 |
| VERSION_STATUS_NEW | 0 | 检测到新版本 |
| VERSION_STATUS_NONE | 1 | 没有检测到新版本 |
| VERSION_STATUS_BUSY | 2 | 检测版本时忙 |
## UpgradeInfo ## UpgradeInfo
升级数据。 升级信息。
**系统能力**：以下各项对应的系统能力均为:SystemCapability.Update.UpdateService **系统能力**：以下各项对应的系统能力均为:SystemCapability.Update.UpdateService
| 名称 | 参数类型 | 必填 | 说明 | | 名称 | 参数类型 | 必填 | 说明 |
| ------------------- | --------------------------- | ---- | ------- | | ------------------- | --------------------------- | ---- | ------- |
| upgradeApp | string | 是 | 调用方包名 | | upgradeApp | string | 是 | 调用方包名 |
| businessType | [BusinessType](#installmode) | 是 | 安装模式 | | businessType | [BusinessType](#installmode) | 是 | 升级业务类型 |
## BusinessType ## BusinessType
...@@ -1124,7 +1071,7 @@ localUpdater.off(eventClassifyInfo, onTaskUpdate); ...@@ -1124,7 +1071,7 @@ localUpdater.off(eventClassifyInfo, onTaskUpdate);
| 名称 | 参数类型 | 必填 | 说明 | | 名称 | 参数类型 | 必填 | 说明 |
| ------------------- | --------------------------- | ---- | ------- | | ------------------- | --------------------------- | ---- | ------- |
| vendor | [BusinessVendor](#businessVendor) | 是 | 设备厂家 | | vendor | [BusinessVendor](#businessVendor) | 是 | 供应商 |
| subType | [BusinessSubType](#businessSubType) | 是 | 类型 | | subType | [BusinessSubType](#businessSubType) | 是 | 类型 |
## CheckResult ## CheckResult
...@@ -1136,7 +1083,7 @@ localUpdater.off(eventClassifyInfo, onTaskUpdate); ...@@ -1136,7 +1083,7 @@ localUpdater.off(eventClassifyInfo, onTaskUpdate);
| 名称 | 参数类型 | 必填 | 说明 | | 名称 | 参数类型 | 必填 | 说明 |
| ------------------- | --------------------------- | ---- | ------- | | ------------------- | --------------------------- | ---- | ------- |
| isExistNewVersion | bool | 是 | 是否有新版本 | | isExistNewVersion | bool | 是 | 是否有新版本 |
| newVersionInfo | [NewVersionInfo](#newVersionInfo) | 否 | 版本数据 | | newVersionInfo | [NewVersionInfo](#newVersionInfo) | 否 | 新版本数据 |
## NewVersionInfo ## NewVersionInfo
...@@ -1146,8 +1093,8 @@ localUpdater.off(eventClassifyInfo, onTaskUpdate); ...@@ -1146,8 +1093,8 @@ localUpdater.off(eventClassifyInfo, onTaskUpdate);
| 名称 | 参数类型 | 必填 | 说明 | | 名称 | 参数类型 | 必填 | 说明 |
| ------------------- | --------------------------- | ---- | ------- | | ------------------- | --------------------------- | ---- | ------- |
| versionDigestInfo | [VersionDigestInfo](#versionDigestInfo) | 是 | 是否有新版本 | | versionDigestInfo | [VersionDigestInfo](#versionDigestInfo) | 是 | 版本摘要 |
| versionComponents | Array\<[VersionComponent](#vesionComponent)> | 否 | 版本数据 | | versionComponents | Array\<[VersionComponent](#vesionComponent)> | 是 | 版本组件 |
## VersionDigestInfo ## VersionDigestInfo
...@@ -1161,30 +1108,30 @@ localUpdater.off(eventClassifyInfo, onTaskUpdate); ...@@ -1161,30 +1108,30 @@ localUpdater.off(eventClassifyInfo, onTaskUpdate);
## VersionComponent ## VersionComponent
升级包数据。 版本组件。
**系统能力**：以下各项对应的系统能力均为:SystemCapability.Update.UpdateService **系统能力**：以下各项对应的系统能力均为:SystemCapability.Update.UpdateService
| 名称 | 参数类型 | 必填 | 说明 | | 名称 | 参数类型 | 必填 | 说明 |
| ------------------- | --------------------------- | ---- | ------- | | ------------------- | --------------------------- | ---- | ------- |
| componentType | [ComponentType](#componentType) | 是 | 升级包类型 | | componentType | [ComponentType](#componentType) | 是 | 组件类型 |
| upgradeAction | [UpgradeAction](#upgradeAction) | 是 | 升级方式 | | upgradeAction | [UpgradeAction](#upgradeAction) | 是 | 升级方式 |
| displayVersion | string | 是 | 显示版本号 | | displayVersion | string | 是 | 显示版本号 |
| innerVersion | string | 是 | 版本号 | | innerVersion | string | 是 | 版本号 |
| size | number | 是 | 升级包大小 | | size | number | 是 | 升级包大小 |
| effectiveMode | [EffectiveMode](#effectiveMode) | 是 | 生效模式 | | effectiveMode | [EffectiveMode](#effectiveMode) | 是 | 生效模式 |
| descriptionInfo | [DescriptionInfo](#descriptionInfo) | 是 | 描述文件信息 | | descriptionInfo | [DescriptionInfo](#descriptionInfo) | 是 | 版本描述文件信息 |
## DescriptionInfo ## DescriptionInfo
升级包描述文件。 版本描述文件信息。
**系统能力**：以下各项对应的系统能力均为:SystemCapability.Update.UpdateService **系统能力**：以下各项对应的系统能力均为:SystemCapability.Update.UpdateService
| 名称 | 参数类型 | 必填 | 说明 | | 名称 | 参数类型 | 必填 | 说明 |
| ------------------- | --------------------------- | ---- | ------- | | ------------------- | --------------------------- | ---- | ------- |
| descriptionType | [DescriptionType](#descriptionType) | 是 | 描述文件类型 | | descriptionType | [DescriptionType](#descriptionType) | 是 | 描述文件类型 |
| content | string | 否 | 描述文件内容 | | content | string | 是 | 描述文件内容 |
## CurrentVersionInfo ## CurrentVersionInfo
...@@ -1195,23 +1142,23 @@ localUpdater.off(eventClassifyInfo, onTaskUpdate); ...@@ -1195,23 +1142,23 @@ localUpdater.off(eventClassifyInfo, onTaskUpdate);
| 名称 | 参数类型 | 必填 | 说明 | | 名称 | 参数类型 | 必填 | 说明 |
| ------------------- | --------------------------- | ---- | ------- | | ------------------- | --------------------------- | ---- | ------- |
| osVersion | string | 是 | 系统版本号 | | osVersion | string | 是 | 系统版本号 |
| deviceName | string | 否 | 设备名 | | deviceName | string | 是 | 设备名 |
| versionComponents | Array\<[VersionComponent](#vesionComponent)> | 否 | 版本数据 | | versionComponents | Array\<[VersionComponent](#vesionComponent)> | 否 | 版本组件 |
## DownloadOptions ## DownloadOptions
下载条件。 下载选项。
**系统能力**：以下各项对应的系统能力均为:SystemCapability.Update.UpdateService **系统能力**：以下各项对应的系统能力均为:SystemCapability.Update.UpdateService
| 名称 | 参数类型 | 必填 | 说明 | | 名称 | 参数类型 | 必填 | 说明 |
| ------------------- | --------------------------- | ---- | ------- | | ------------------- | --------------------------- | ---- | ------- |
| allowNetwork | [NetType](#netType) | 是 | 网络类型 | | allowNetwork | [NetType](#netType) | 是 | 网络类型 |
| order | [Order](#order) | 否 | 升级指令 | | order | [Order](#order) | 是 | 升级指令 |
## ResumeDownloadOptions ## ResumeDownloadOptions
恢复下载条件。 恢复下载选项。
**系统能力**：以下各项对应的系统能力均为:SystemCapability.Update.UpdateService **系统能力**：以下各项对应的系统能力均为:SystemCapability.Update.UpdateService
...@@ -1221,7 +1168,7 @@ localUpdater.off(eventClassifyInfo, onTaskUpdate); ...@@ -1221,7 +1168,7 @@ localUpdater.off(eventClassifyInfo, onTaskUpdate);
## PauseDownloadOptions ## PauseDownloadOptions
暂停下载条件。 暂停下载选项。
**系统能力**：以下各项对应的系统能力均为:SystemCapability.Update.UpdateService **系统能力**：以下各项对应的系统能力均为:SystemCapability.Update.UpdateService
...@@ -1231,23 +1178,23 @@ localUpdater.off(eventClassifyInfo, onTaskUpdate); ...@@ -1231,23 +1178,23 @@ localUpdater.off(eventClassifyInfo, onTaskUpdate);
## UpgradeOptions ## UpgradeOptions
升级条件。 升级选项。
**系统能力**：以下各项对应的系统能力均为:SystemCapability.Update.UpdateService **系统能力**：以下各项对应的系统能力均为:SystemCapability.Update.UpdateService
| 名称 | 参数类型 | 必填 | 说明 | | 名称 | 参数类型 | 必填 | 说明 |
| ------------------- | --------------------------- | ---- | ------- | | ------------------- | --------------------------- | ---- | ------- |
| order | [Order](#order) | 否 | 升级指令 | | order | [Order](#order) | 是 | 升级指令 |
## ClearOptions ## ClearOptions
升级条件。 清除异常选项。
**系统能力**：以下各项对应的系统能力均为:SystemCapability.Update.UpdateService **系统能力**：以下各项对应的系统能力均为:SystemCapability.Update.UpdateService
| 名称 | 参数类型 | 必填 | 说明 | | 名称 | 参数类型 | 必填 | 说明 |
| ------------------- | --------------------------- | ---- | ------- | | ------------------- | --------------------------- | ---- | ------- |
| status | [UpgradeStatus](#upgradeStatus) | 否 | 升级指令 | | status | [UpgradeStatus](#upgradeStatus) | 是 | 异常状态 |
## UpgradePolicy ## UpgradePolicy
...@@ -1257,8 +1204,8 @@ localUpdater.off(eventClassifyInfo, onTaskUpdate); ...@@ -1257,8 +1204,8 @@ localUpdater.off(eventClassifyInfo, onTaskUpdate);
| 名称 | 参数类型 | 必填 | 说明 | | 名称 | 参数类型 | 必填 | 说明 |
| ------------------- | --------------------------- | ---- | ------- | | ------------------- | --------------------------- | ---- | ------- |
| downloadStrategy | bool | 是 | 下载开关 | | downloadStrategy | bool | 是 | 自动下载策略 |
| autoUpgradeStrategy | bool | 是 | 自动升级开关 | | autoUpgradeStrategy | bool | 是 | 自动升级策略 |
| autoUpgradePeriods | Array\<[UpgradePeriod](#upgradePeriod)> | 是 | 自动升级时间段 | | autoUpgradePeriods | Array\<[UpgradePeriod](#upgradePeriod)> | 是 | 自动升级时间段 |
## UpgradePeriod ## UpgradePeriod
...@@ -1274,52 +1221,52 @@ localUpdater.off(eventClassifyInfo, onTaskUpdate); ...@@ -1274,52 +1221,52 @@ localUpdater.off(eventClassifyInfo, onTaskUpdate);
## TaskInfo ## TaskInfo
任务数据。 任务信息。
**系统能力**：以下各项对应的系统能力均为:SystemCapability.Update.UpdateService **系统能力**：以下各项对应的系统能力均为:SystemCapability.Update.UpdateService
| 名称 | 参数类型 | 必填 | 说明 | | 名称 | 参数类型 | 必填 | 说明 |
| ------------------- | --------------------------- | ---- | ------- | | ------------------- | --------------------------- | ---- | ------- |
| exisTask | bool | 是 | 是否存在任务 | | exisTask | bool | 是 | 是否存在任务 |
| taskBody | [TaskBody](#taskinfo) | 是 | 任务体 | | taskBody | [TaskBody](#taskinfo) | 是 | 任务数据 |
## EventInfo ## EventInfo
任务数据。 事件信息。
**系统能力**：以下各项对应的系统能力均为:SystemCapability.Update.UpdateService **系统能力**：以下各项对应的系统能力均为:SystemCapability.Update.UpdateService
| 名称 | 参数类型 | 必填 | 说明 | | 名称 | 参数类型 | 必填 | 说明 |
| ------------------- | --------------------------- | ---- | ------- | | ------------------- | --------------------------- | ---- | ------- |
| eventId | [EventId](#eventId) | 是 | 事件ID | | eventId | [EventId](#eventId) | 是 | 事件ID |
| taskBody | [TaskBody](#taskinfo) | 是 | 任务体 | | taskBody | [TaskBody](#taskinfo) | 是 | 任务数据 |
## TaskBody ## TaskBody
任务体。 任务数据。
**系统能力**：以下各项对应的系统能力均为:SystemCapability.Update.UpdateService **系统能力**：以下各项对应的系统能力均为:SystemCapability.Update.UpdateService
| 名称 | 参数类型 | 必填 | 说明 | | 名称 | 参数类型 | 必填 | 说明 |
| ------------------- | --------------------------- | ---- | ------- | | ------------------- | --------------------------- | ---- | ------- |
| versionDigestInfo | [VersionDigestInfo](#versionDigestInfo) | 是 | 版本摘要 | | versionDigestInfo | [VersionDigestInfo](#versionDigestInfo) | 是 | 版本摘要 |
| status | [UpgradeStatus](#upgradeStatus) | 是 | 状态 | | status | [UpgradeStatus](#upgradeStatus) | 是 | 升级状态 |
| subStatus | number | 否 | 子状态 | | subStatus | number | 否 | 子状态 |
| progress | number | 是 | 进度 | | progress | number | 是 | 进度 |
| installMode | number | 是 | 安装模式 | | installMode | number | 是 | 安装模式 |
| errorMessages | Array\<[ErrorMessage](#errorMessage)> | 否 | 错误内容 | | errorMessages | Array\<[ErrorMessage](#errorMessage)> | 否 | 错误内容 |
| versionComponets | Array\<[VersionComponet](#versionComponet)> | 是 | 版本列表 | | versionComponets | Array\<[VersionComponet](#versionComponet)> | 是 | 版本组件 |
## ErrorMessage ## ErrorMessage
错误消息。 错误信息。
**系统能力**：以下各项对应的系统能力均为:SystemCapability.Update.UpdateService **系统能力**：以下各项对应的系统能力均为:SystemCapability.Update.UpdateService
| 名称 | 参数类型 | 必填 | 说明 | | 名称 | 参数类型 | 必填 | 说明 |
| ------------------- | --------------------------- | ---- | ------- | | ------------------- | --------------------------- | ---- | ------- |
| errorCode | number | 是 | 错误码 | | errorCode | number | 是 | 错误码 |
| errorMessage | string | 否 | 错误描述 | | errorMessage | string | 是 | 错误描述 |
## UpgradeFile ## UpgradeFile
...@@ -1334,13 +1281,15 @@ localUpdater.off(eventClassifyInfo, onTaskUpdate); ...@@ -1334,13 +1281,15 @@ localUpdater.off(eventClassifyInfo, onTaskUpdate);
## UpgradeTaskCallback ## UpgradeTaskCallback
### onTaskUpdate(eventInfo: [EventInfo](#eventInfo))
更新事件回调。 更新事件回调。
**系统能力**：以下各项对应的系统能力均为:SystemCapability.Update.UpdateService **系统能力**：以下各项对应的系统能力均为:SystemCapability.Update.UpdateService
| 名称 | 参数类型 | 必填 | 说明 | | 名称 | 参数类型 | 必填 | 说明 |
| --------------- | ---------------------------------------- | ---- | ---- | | --------------- | ---------------------------------------- | ---- | ---- |
| function(eventInfo) | function([EventInfo](#eventInfo)) | 是 | 事件信息回调 | | eventInfo | [EventInfo](#eventInfo) | 是 | 事件信息 |
## NewVersionInfo ## NewVersionInfo
......
Markdown is supported
0% 或 .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑！
想要评论请 注册 或