interface_sdk-js/api/@ohos.update.d.ts
邹友松 a2fa039944 修改 202 错误码注释
Signed-off-by: 邹友松 <zouyousong1@h-partners.com>
2024-07-25 19:20:03 +08:00

2073 lines
59 KiB
TypeScript

/*
* Copyright (c) 2022 Huawei Device Co., Ltd.
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/**
* @file
* @kit BasicServicesKit
*/
import type { AsyncCallback } from './@ohos.base';
/**
* A static class to do update for device.
*
* @namespace update
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
declare namespace update {
/**
* Get online update handler for the calling device.
*
* @param { UpgradeInfo } upgradeInfo - Indicates client app and business type.
* @returns { Updater } online update handler to perform online update.
* @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API.
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
function getOnlineUpdater(upgradeInfo: UpgradeInfo): Updater;
/**
* Get restore handler.
*
* @returns { Restorer } restore handler to perform factory reset.
* @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API.
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
function getRestorer(): Restorer;
/**
* Get local update handler.
*
* @returns { LocalUpdater } local update handler to perform local update.
* @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API.
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
function getLocalUpdater(): LocalUpdater;
/**
* A static class to do online update.
*
* @interface Updater
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
export interface Updater {
/**
* Check new version.
*
* @permission ohos.permission.UPDATE_SYSTEM
* @param { AsyncCallback<CheckResult> } callback - Callback used to return the result.
* @throws { BusinessError } 201 - Permission denied.
* @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API.
* @throws { BusinessError } 11500104 - IPC error.
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
checkNewVersion(callback: AsyncCallback<CheckResult>): void;
/**
* Check new version.
*
* @permission ohos.permission.UPDATE_SYSTEM
* @returns { Promise<CheckResult> } Promise used to return the result.
* @throws { BusinessError } 201 - Permission denied.
* @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API.
* @throws { BusinessError } 11500104 - IPC error.
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
checkNewVersion(): Promise<CheckResult>;
/**
* Get new version.
*
* @permission ohos.permission.UPDATE_SYSTEM
* @param { AsyncCallback<NewVersionInfo> } callback - Callback used to return the result.
* @throws { BusinessError } 201 - Permission denied.
* @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API.
* @throws { BusinessError } 11500104 - IPC error.
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
getNewVersionInfo(callback: AsyncCallback<NewVersionInfo>): void;
/**
* Get new version.
*
* @permission ohos.permission.UPDATE_SYSTEM
* @returns { Promise<NewVersionInfo> } Promise used to return the result.
* @throws { BusinessError } 201 - Permission denied.
* @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API.
* @throws { BusinessError } 11500104 - IPC error.
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
getNewVersionInfo(): Promise<NewVersionInfo>;
/**
* Get new version description.
*
* @permission ohos.permission.UPDATE_SYSTEM
* @param { VersionDigestInfo } versionDigestInfo - Version digest information.
* @param { DescriptionOptions } descriptionOptions - Options of the description file.
* @param { AsyncCallback<Array<ComponentDescription>> } callback - Callback used to return the result.
* @throws { BusinessError } 201 - Permission denied.
* @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API.
* @throws { BusinessError } 401 - Parameter verification failed.
* @throws { BusinessError } 11500104 - IPC error.
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
getNewVersionDescription(
versionDigestInfo: VersionDigestInfo,
descriptionOptions: DescriptionOptions,
callback: AsyncCallback<Array<ComponentDescription>>
): void;
/**
* Get new version description.
*
* @permission ohos.permission.UPDATE_SYSTEM
* @param { VersionDigestInfo } versionDigestInfo - Version digest information.
* @param { DescriptionOptions } descriptionOptions - Options of the description file.
* @returns { Promise<Array<ComponentDescription>> } Promise used to return the result.
* @throws { BusinessError } 201 - Permission denied.
* @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API.
* @throws { BusinessError } 401 - Parameter verification failed.
* @throws { BusinessError } 11500104 - IPC error.
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
getNewVersionDescription(
versionDigestInfo: VersionDigestInfo,
descriptionOptions: DescriptionOptions
): Promise<Array<ComponentDescription>>;
/**
* Get current version.
*
* @permission ohos.permission.UPDATE_SYSTEM
* @param { AsyncCallback<CurrentVersionInfo> } callback - Callback used to return the result.
* @throws { BusinessError } 201 - Permission denied.
* @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API.
* @throws { BusinessError } 11500104 - IPC error.
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
getCurrentVersionInfo(callback: AsyncCallback<CurrentVersionInfo>): void;
/**
* Get current version.
*
* @permission ohos.permission.UPDATE_SYSTEM
* @returns { Promise<CurrentVersionInfo> } Promise used to return the result.
* @throws { BusinessError } 201 - Permission denied.
* @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API.
* @throws { BusinessError } 11500104 - IPC error.
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
getCurrentVersionInfo(): Promise<CurrentVersionInfo>;
/**
* Get current version description.
*
* @permission ohos.permission.UPDATE_SYSTEM
* @param { DescriptionOptions } descriptionOptions - Options of the description file.
* @param { AsyncCallback<Array<ComponentDescription>> } callback - Callback used to return the result.
* @throws { BusinessError } 201 - Permission denied.
* @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API.
* @throws { BusinessError } 401 - Parameter verification failed.
* @throws { BusinessError } 11500104 - IPC error.
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
getCurrentVersionDescription(
descriptionOptions: DescriptionOptions,
callback: AsyncCallback<Array<ComponentDescription>>
): void;
/**
* Get current version description.
*
* @permission ohos.permission.UPDATE_SYSTEM
* @param { DescriptionOptions } descriptionOptions - Options of the description file.
* @returns { Promise<Array<ComponentDescription>> } Promise used to return the result.
* @throws { BusinessError } 201 - Permission denied.
* @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API.
* @throws { BusinessError } 401 - Parameter verification failed.
* @throws { BusinessError } 11500104 - IPC error.
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
getCurrentVersionDescription(descriptionOptions: DescriptionOptions): Promise<Array<ComponentDescription>>;
/**
* Get task info.
*
* @permission ohos.permission.UPDATE_SYSTEM
* @param { AsyncCallback<TaskInfo> } callback - Callback used to return the result.
* @throws { BusinessError } 201 - Permission denied.
* @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API.
* @throws { BusinessError } 11500104 - IPC error.
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
getTaskInfo(callback: AsyncCallback<TaskInfo>): void;
/**
* Get task info.
*
* @permission ohos.permission.UPDATE_SYSTEM
* @returns { Promise<TaskInfo> } Promise used to return the result.
* @throws { BusinessError } 201 - Permission denied.
* @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API.
* @throws { BusinessError } 11500104 - IPC error.
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
getTaskInfo(): Promise<TaskInfo>;
/**
* Trigger download new version packages.
* Apps should listen to task update event
*
* @permission ohos.permission.UPDATE_SYSTEM
* @param { VersionDigestInfo } versionDigestInfo - Version digest information.
* @param { DownloadOptions } downloadOptions - Download options.
* @param { AsyncCallback<void> } callback - Callback used to return the result.
* If the operation is successful, `err` is `undefined`; otherwise, `err` is an `Error` object.
* @throws { BusinessError } 201 - Permission denied.
* @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API.
* @throws { BusinessError } 401 - Parameter verification failed.
* @throws { BusinessError } 11500104 - IPC error.
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
download(
versionDigestInfo: VersionDigestInfo,
downloadOptions: DownloadOptions,
callback: AsyncCallback<void>
): void;
/**
* Trigger download new version packages.
* Apps should listen to task update event
*
* @permission ohos.permission.UPDATE_SYSTEM
* @param { VersionDigestInfo } versionDigestInfo - Version digest information.
* @param { DownloadOptions } downloadOptions - Download options.
* @returns { Promise<void> } Promise that returns no value.
* @throws { BusinessError } 201 - Permission denied.
* @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API.
* @throws { BusinessError } 401 - Parameter verification failed.
* @throws { BusinessError } 11500104 - IPC error.
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
download(versionDigestInfo: VersionDigestInfo, downloadOptions: DownloadOptions): Promise<void>;
/**
* Resume download new version packages.
* Apps should listen to task update event
*
* @permission ohos.permission.UPDATE_SYSTEM
* @param { VersionDigestInfo } versionDigestInfo - Version digest information.
* @param { ResumeDownloadOptions } resumeDownloadOptions - Options for resume download.
* @param { AsyncCallback<void> } callback - Callback used to return the result.
* If the operation is successful, `err` is `undefined`; otherwise, `err` is an `Error` object.
* @throws { BusinessError } 201 - Permission denied.
* @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API.
* @throws { BusinessError } 401 - Parameter verification failed.
* @throws { BusinessError } 11500104 - IPC error.
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
resumeDownload(
versionDigestInfo: VersionDigestInfo,
resumeDownloadOptions: ResumeDownloadOptions,
callback: AsyncCallback<void>
): void;
/**
* Resume download new version packages.
* Apps should listen to task update event
*
* @permission ohos.permission.UPDATE_SYSTEM
* @param { VersionDigestInfo } versionDigestInfo - Version digest information.
* @param { ResumeDownloadOptions } resumeDownloadOptions - Options for resume download.
* @returns { Promise<void> } Promise that returns no value.
* @throws { BusinessError } 201 - Permission denied.
* @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API.
* @throws { BusinessError } 401 - Parameter verification failed.
* @throws { BusinessError } 11500104 - IPC error.
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
resumeDownload(versionDigestInfo: VersionDigestInfo, resumeDownloadOptions: ResumeDownloadOptions): Promise<void>;
/**
* Pause download new version packages.
* Apps should listen to task update event
*
* @permission ohos.permission.UPDATE_SYSTEM
* @param { VersionDigestInfo } versionDigestInfo - Version digest information.
* @param { PauseDownloadOptions } pauseDownloadOptions - Options for pause download.
* @param { AsyncCallback<void> } callback - Callback used to return the result.
* If the operation is successful, `err` is `undefined`; otherwise, `err` is an `Error` object.
* @throws { BusinessError } 201 - Permission denied.
* @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API.
* @throws { BusinessError } 401 - Parameter verification failed.
* @throws { BusinessError } 11500104 - IPC error.
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
pauseDownload(
versionDigestInfo: VersionDigestInfo,
pauseDownloadOptions: PauseDownloadOptions,
callback: AsyncCallback<void>
): void;
/**
* Pause download new version packages.
* Apps should listen to task update event
*
* @permission ohos.permission.UPDATE_SYSTEM
* @param { VersionDigestInfo } versionDigestInfo - Version digest information.
* @param { PauseDownloadOptions } pauseDownloadOptions - Options for pause download.
* @returns { Promise<void> } Promise that returns no value.
* @throws { BusinessError } 201 - Permission denied.
* @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API.
* @throws { BusinessError } 401 - Parameter verification failed.
* @throws { BusinessError } 11500104 - IPC error.
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
pauseDownload(versionDigestInfo: VersionDigestInfo, pauseDownloadOptions: PauseDownloadOptions): Promise<void>;
/**
* Install packages for the device.
* Apps should listen to task update event
*
* @permission ohos.permission.UPDATE_SYSTEM
* @param { VersionDigestInfo } versionDigestInfo - Version digest information.
* @param { UpgradeOptions } upgradeOptions - Update options.
* @param { AsyncCallback<void> } callback - Callback used to return the result.
* If the operation is successful, `err` is `undefined`; otherwise, `err` is an `Error` object.
* @throws { BusinessError } 201 - Permission denied.
* @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API.
* @throws { BusinessError } 401 - Parameter verification failed.
* @throws { BusinessError } 11500104 - IPC error.
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
upgrade(versionDigestInfo: VersionDigestInfo, upgradeOptions: UpgradeOptions, callback: AsyncCallback<void>): void;
/**
* Install packages for the device.
* Apps should listen to task update event
*
* @permission ohos.permission.UPDATE_SYSTEM
* @param { VersionDigestInfo } versionDigestInfo - Version digest information.
* @param { UpgradeOptions } upgradeOptions - Update options.
* @returns { Promise<void> } Promise that returns no value.
* @throws { BusinessError } 201 - Permission denied.
* @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API.
* @throws { BusinessError } 401 - Parameter verification failed.
* @throws { BusinessError } 11500104 - IPC error.
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
upgrade(versionDigestInfo: VersionDigestInfo, upgradeOptions: UpgradeOptions): Promise<void>;
/**
* Clear error during upgrade.
*
* @permission ohos.permission.UPDATE_SYSTEM
* @param { VersionDigestInfo } versionDigestInfo - Version digest information.
* @param { ClearOptions } clearOptions - Clear options.
* @param { AsyncCallback<void> } callback - Callback used to return the result.
* If the operation is successful, `err` is `undefined`; otherwise, `err` is an `Error` object.
* @throws { BusinessError } 201 - Permission denied.
* @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API.
* @throws { BusinessError } 401 - Parameter verification failed.
* @throws { BusinessError } 11500104 - IPC error.
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
clearError(versionDigestInfo: VersionDigestInfo, clearOptions: ClearOptions, callback: AsyncCallback<void>): void;
/**
* Clear error during upgrade.
*
* @permission ohos.permission.UPDATE_SYSTEM
* @param { VersionDigestInfo } versionDigestInfo - Version digest information.
* @param { ClearOptions } clearOptions - Clear options.
* @returns { Promise<void> } Promise that returns no value.
* @throws { BusinessError } 201 - Permission denied.
* @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API.
* @throws { BusinessError } 401 - Parameter verification failed.
* @throws { BusinessError } 11500104 - IPC error.
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
clearError(versionDigestInfo: VersionDigestInfo, clearOptions: ClearOptions): Promise<void>;
/**
* Get current upgrade policy.
*
* @permission ohos.permission.UPDATE_SYSTEM
* @param { AsyncCallback<UpgradePolicy> } callback - Callback used to return the result.
* @throws { BusinessError } 201 - Permission denied.
* @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API.
* @throws { BusinessError } 11500104 - IPC error.
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
getUpgradePolicy(callback: AsyncCallback<UpgradePolicy>): void;
/**
* Get current upgrade policy.
*
* @permission ohos.permission.UPDATE_SYSTEM
* @returns { Promise<UpgradePolicy> } Promise used to return the result.
* @throws { BusinessError } 201 - Permission denied.
* @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API.
* @throws { BusinessError } 11500104 - IPC error.
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
getUpgradePolicy(): Promise<UpgradePolicy>;
/**
* Set upgrade policy.
*
* @permission ohos.permission.UPDATE_SYSTEM
* @param { UpgradePolicy } policy - Update policy.
* @param { AsyncCallback<void> } callback - Callback used to return the result.
* @throws { BusinessError } 201 - Permission denied.
* @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API.
* @throws { BusinessError } 11500104 - IPC error.
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
setUpgradePolicy(policy: UpgradePolicy, callback: AsyncCallback<void>): void;
/**
* Set upgrade policy.
*
* @permission ohos.permission.UPDATE_SYSTEM
* @param { UpgradePolicy } policy - Update policy.
* @returns { Promise<void> } Promise that returns no value.
* @throws { BusinessError } 201 - Permission denied.
* @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API.
* @throws { BusinessError } 11500104 - IPC error.
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
setUpgradePolicy(policy: UpgradePolicy): Promise<void>;
/**
* Terminate upgrade task.
*
* @permission ohos.permission.UPDATE_SYSTEM
* @param { AsyncCallback<void> } callback - Callback used to return the result.
* If the operation is successful, 'err' is 'undefined'; otherwise, 'err' is an 'Error' object.
* @throws { BusinessError } 201 - Permission denied.
* @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API.
* @throws { BusinessError } 11500104 - IPC error.
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
terminateUpgrade(callback: AsyncCallback<void>): void;
/**
* Terminate upgrade task.
*
* @permission ohos.permission.UPDATE_SYSTEM
* @returns { Promise<void> } Promise that returns no value.
* @throws { BusinessError } 201 - Permission denied.
* @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API.
* @throws { BusinessError } 11500104 - IPC error.
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
terminateUpgrade(): Promise<void>;
/**
* Subscribe task update events
*
* @param { EventClassifyInfo } eventClassifyInfo - Event information.
* @param { UpgradeTaskCallback } taskCallback - Event callback.
* @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API.
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
on(eventClassifyInfo: EventClassifyInfo, taskCallback: UpgradeTaskCallback): void;
/**
* Unsubscribe task update events
*
* @param { EventClassifyInfo } eventClassifyInfo - Event information.
* @param { UpgradeTaskCallback } taskCallback - Event callback.
* @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API.
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
off(eventClassifyInfo: EventClassifyInfo, taskCallback?: UpgradeTaskCallback): void;
}
/**
* A static class to do restore.
*
* @interface Restorer
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
export interface Restorer {
/**
* Reboot and clean user data.
*
* @permission ohos.permission.FACTORY_RESET
* @param { AsyncCallback<void> } callback - Callback used to return the result.
* If the operation is successful, `err` is `undefined`; otherwise, `err` is an `Error` object.
* @throws { BusinessError } 201 - Permission denied.
* @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API.
* @throws { BusinessError } 11500104 - IPC error.
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
factoryReset(callback: AsyncCallback<void>): void;
/**
* Reboot and clean user data.
*
* @permission ohos.permission.FACTORY_RESET
* @returns { Promise<void> } Promise that returns no value.
* @throws { BusinessError } 201 - Permission denied.
* @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API.
* @throws { BusinessError } 11500104 - IPC error.
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
factoryReset(): Promise<void>;
}
/**
* A static class to do local update.
*
* @interface LocalUpdater
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
export interface LocalUpdater {
/**
* Verify local update package.
*
* @permission ohos.permission.UPDATE_SYSTEM
* @param { UpgradeFile } upgradeFile - Update file.
* @param { string } certsFile - Path of the certificate file.
* @param { AsyncCallback<void> } callback - Callback used to return the verify upgrade package result.
* @throws { BusinessError } 201 - Permission denied.
* @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API.
* @throws { BusinessError } 401 - Parameter verification failed.
* @throws { BusinessError } 11500104 - IPC error.
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
verifyUpgradePackage(upgradeFile: UpgradeFile, certsFile: string, callback: AsyncCallback<void>): void;
/**
* Verify local update package.
*
* @permission ohos.permission.UPDATE_SYSTEM
* @param { UpgradeFile } upgradeFile - Update file.
* @param { string } certsFile - Path of the certificate file.
* @returns { Promise<void> } Promise that returns no value.
* @throws { BusinessError } 201 - Permission denied.
* @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API.
* @throws { BusinessError } 401 - Parameter verification failed.
* @throws { BusinessError } 11500104 - IPC error.
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
verifyUpgradePackage(upgradeFile: UpgradeFile, certsFile: string): Promise<void>;
/**
* Apply local update package.
* Apps should listen to task update event
*
* @permission ohos.permission.UPDATE_SYSTEM
* @param { Array<UpgradeFile> } upgradeFiles - Update files.
* @param { AsyncCallback<void> } callback - Callback used to return the apply new version result.
* @throws { BusinessError } 201 - Permission denied.
* @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API.
* @throws { BusinessError } 401 - Parameter verification failed.
* @throws { BusinessError } 11500104 - IPC error.
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
applyNewVersion(upgradeFiles: Array<UpgradeFile>, callback: AsyncCallback<void>): void;
/**
* Apply local update package.
* Apps should listen to task update event
*
* @permission ohos.permission.UPDATE_SYSTEM
* @param { Array<UpgradeFile> } upgradeFiles - Update files.
* @returns { Promise<void> } Promise that returns no value.
* @throws { BusinessError } 201 - Permission denied.
* @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API.
* @throws { BusinessError } 401 - Parameter verification failed.
* @throws { BusinessError } 11500104 - IPC error.
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
applyNewVersion(upgradeFiles: Array<UpgradeFile>): Promise<void>;
/**
* Subscribe task update events
*
* @param { EventClassifyInfo } eventClassifyInfo - Event information.
* @param { UpgradeTaskCallback } taskCallback - Event callback.
* @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API.
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
on(eventClassifyInfo: EventClassifyInfo, taskCallback: UpgradeTaskCallback): void;
/**
* Unsubscribe task update events
*
* @param { EventClassifyInfo } eventClassifyInfo - Event information.
* @param { UpgradeTaskCallback } taskCallback - Event callback.
* @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API.
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
off(eventClassifyInfo: EventClassifyInfo, taskCallback?: UpgradeTaskCallback): void;
}
/**
* Represents upgrade info.
*
* @typedef UpgradeInfo
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
export interface UpgradeInfo {
/**
* Upgrade client package name
*
* @type { string }
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
upgradeApp: string;
/**
* BusinessType of upgrade
*
* @type { BusinessType }
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
businessType: BusinessType;
}
/**
* Represents business type.
*
* @typedef BusinessType
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
export interface BusinessType {
/**
* Vendor of business type
*
* @type { BusinessVendor }
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
vendor: BusinessVendor;
/**
* Update service type
*
* @type { BusinessSubType }
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
subType: BusinessSubType;
}
/**
* Represents new version check result.
*
* @typedef CheckResult
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
export interface CheckResult {
/**
* New version exist or not
*
* @type { boolean }
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
isExistNewVersion: boolean;
/**
* New version info
*
* @type { NewVersionInfo }
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
newVersionInfo: NewVersionInfo;
}
/**
* Represents new version info.
*
* @typedef NewVersionInfo
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
export interface NewVersionInfo {
/**
* Digest info of new version
*
* @type { VersionDigestInfo }
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
versionDigestInfo: VersionDigestInfo;
/**
* New version component array
*
* @type { Array<VersionComponent> }
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
versionComponents: Array<VersionComponent>;
}
/**
* Represents version digest info.
*
* @typedef VersionDigestInfo
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
export interface VersionDigestInfo {
/**
* Version digest value
*
* @type { string }
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
versionDigest: string;
}
/**
* Represents version component info.
*
* @typedef VersionComponent
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
export interface VersionComponent {
/**
* Version component id
*
* @type { string }
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
componentId: string;
/**
* Version component type
*
* @type { ComponentType }
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
componentType: ComponentType;
/**
* Upgrade action
*
* @type { UpgradeAction }
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
upgradeAction: UpgradeAction;
/**
* Display version number
*
* @type { string }
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
displayVersion: string;
/**
* Internal version number
*
* @type { string }
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
innerVersion: string;
/**
* Update package size
*
* @type { number }
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
size: number;
/**
* Effective mode
*
* @type { EffectiveMode }
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
effectiveMode: EffectiveMode;
/**
* Information about the version description file
*
* @type { DescriptionInfo }
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
descriptionInfo: DescriptionInfo;
}
/**
* Represents description options.
*
* @typedef DescriptionOptions
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
export interface DescriptionOptions {
/**
* Format of the description file
*
* @type { DescriptionFormat }
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
format: DescriptionFormat;
/**
* Language of the description file
*
* @type { string }
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
language: string;
}
/**
* Represents version component description.
*
* @typedef ComponentDescription
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
export interface ComponentDescription {
/**
* Component id
*
* @type { string }
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
componentId: string;
/**
* Information about the description file
*
* @type { DescriptionInfo }
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
descriptionInfo: DescriptionInfo;
}
/**
* Represents new version description information.
*
* @typedef DescriptionInfo
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
export interface DescriptionInfo {
/**
* Description content type
*
* @type { DescriptionType }
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
descriptionType: DescriptionType;
/**
* Content of the description file
*
* @type { string }
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
content: string;
}
/**
* Represents current version info.
*
* @typedef CurrentVersionInfo
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
export interface CurrentVersionInfo {
/**
* System version number
*
* @type { string }
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
osVersion: string;
/**
* Device name
*
* @type { string }
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
deviceName: string;
/**
* Current version component array
*
* @type { Array<VersionComponent> }
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
versionComponents: Array<VersionComponent>;
}
/**
* Represents download options.
*
* @typedef DownloadOptions
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
export interface DownloadOptions {
/**
* Allow download with the network type
*
* @type { NetType }
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
allowNetwork: NetType;
/**
* Upgrade command
*
* @type { Order }
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
order: Order;
}
/**
* Represents resume download options.
*
* @typedef ResumeDownloadOptions
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
export interface ResumeDownloadOptions {
/**
* Allow download with the network type
*
* @type { NetType }
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
allowNetwork: NetType;
}
/**
* Represents pause download options.
*
* @typedef PauseDownloadOptions
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
export interface PauseDownloadOptions {
/**
* Whether allow auto resume when net available
*
* @type { boolean }
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
isAllowAutoResume: boolean;
}
/**
* Represents upgrade options.
*
* @typedef UpgradeOptions
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
export interface UpgradeOptions {
/**
* Upgrade command
*
* @type { Order }
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
order: Order;
}
/**
* Represents clear error options.
*
* @typedef ClearOptions
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
export interface ClearOptions {
/**
* Clear status error
*
* @type { UpgradeStatus }
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
status: UpgradeStatus;
}
/**
* Represents upgrade policy.
*
* @typedef UpgradePolicy
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
export interface UpgradePolicy {
/**
* Download strategy: open or close
*
* @type { boolean }
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
downloadStrategy: boolean;
/**
* Auto upgrade strategy: open or close
*
* @type { boolean }
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
autoUpgradeStrategy: boolean;
/**
* Auto upgrade period
*
* @type { Array<UpgradePeriod> }
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
autoUpgradePeriods: Array<UpgradePeriod>;
}
/**
* Represents upgrade period.
*
* @typedef UpgradePeriod
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
export interface UpgradePeriod {
/**
* Start time of upgrade period
*
* @type { number }
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
start: number;
/**
* End time of upgrade period
*
* @type { number }
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
end: number;
}
/**
* Represents task info.
*
* @typedef TaskInfo
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
export interface TaskInfo {
/**
* Whether upgrade task exist
*
* @type { boolean }
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
existTask: boolean;
/**
* Task body info
*
* @type { TaskBody }
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
taskBody: TaskBody;
}
/**
* Represents event info.
*
* @typedef EventInfo
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
export interface EventInfo {
/**
* Event id
*
* @type { EventId }
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
eventId: EventId;
/**
* Task body info
*
* @type { TaskBody }
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
taskBody: TaskBody;
}
/**
* Represents task body info.
*
* @typedef TaskBody
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
export interface TaskBody {
/**
* Digest info of new version
*
* @type { VersionDigestInfo }
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
versionDigestInfo: VersionDigestInfo;
/**
* Upgrade status
*
* @type { UpgradeStatus }
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
status: UpgradeStatus;
/**
* Upgrade sub status
*
* @type { number }
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
subStatus: number;
/**
* Upgrade progress
*
* @type { number }
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
progress: number;
/**
* Install mode
*
* @type { number }
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
installMode: number;
/**
* Error messages
*
* @type { Array<ErrorMessage> }
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
errorMessages: Array<ErrorMessage>;
/**
* Version component array
*
* @type { Array<VersionComponent> }
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
versionComponents: Array<VersionComponent>;
}
/**
* Represents error message.
*
* @typedef ErrorMessage
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
export interface ErrorMessage {
/**
* Error code
*
* @type { number }
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
errorCode: number;
/**
* Error message
*
* @type { string }
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
errorMessage: string;
}
/**
* Represents event classify info.
*
* @typedef EventClassifyInfo
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
export interface EventClassifyInfo {
/**
* Event classify
*
* @type { EventClassify }
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
eventClassify: EventClassify;
/**
* Additional information
*
* @type { string }
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
extraInfo: string;
}
/**
* Represents upgrade file info.
*
* @typedef UpgradeFile
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
export interface UpgradeFile {
/**
* Upgrade file type
*
* @type { ComponentType }
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
fileType: ComponentType;
/**
* Upgrade file path
*
* @type { string }
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
filePath: string;
}
/**
* Called when upgrade task info changes.
* You need to implement this method in a child class.
*
* @typedef UpgradeTaskCallback
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
export interface UpgradeTaskCallback {
/**
* Event callback.
*
* @param { EventInfo } eventInfo - Event information.
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
(eventInfo: EventInfo): void;
}
/**
* Enumerates business vendor type.
*
* @enum { string }
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
export enum BusinessVendor {
/**
* Device vendor is open source.
*
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
PUBLIC = 'public'
}
/**
* Enumerates business sub type.
*
* @enum { number }
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
export enum BusinessSubType {
/**
* Business sub type is Firmware.
*
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
FIRMWARE = 1
}
/**
* Enumerates component type.
*
* @enum { number }
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
export enum ComponentType {
/**
* Component type is OTA.
*
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
OTA = 1
}
/**
* Enumerates upgrade action type.
*
* @enum { string }
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
export enum UpgradeAction {
/**
* Differential package.
*
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
UPGRADE = 'upgrade',
/**
* Recovery package.
*
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
RECOVERY = 'recovery'
}
/**
* Enumerates effective mode.
*
* @enum { number }
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
export enum EffectiveMode {
/**
* Cold update.
*
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
COLD = 1,
/**
* Live update.
*
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
LIVE = 2,
/**
* Hybrid live and cold update.
*
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
LIVE_AND_COLD = 3
}
/**
* Enumerates description type.
*
* @enum { number }
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
export enum DescriptionType {
/**
* Description type is content.
*
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
CONTENT = 0,
/**
* Description type is link.
*
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
URI = 1
}
/**
* Enumerates description format.
*
* @enum { number }
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
export enum DescriptionFormat {
/**
* Description format is standard format.
*
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
STANDARD = 0,
/**
* Description format is Simple format.
*
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
SIMPLIFIED = 1
}
/**
* Enumerates network type.
*
* @enum { number }
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
export enum NetType {
/**
* Network type is data network.
*
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
CELLULAR = 1,
/**
* Network type is Wi-Fi hotspot.
*
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
METERED_WIFI = 2,
/**
* Network type is non Wi-Fi hotspot.
*
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
NOT_METERED_WIFI = 4,
/**
* Network type is Wi-Fi.
*
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
WIFI = 6,
/**
* Network type is data network and Wi-Fi.
*
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
CELLULAR_AND_WIFI = 7
}
/**
* Enumerates upgrade order.
*
* @enum { number }
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
export enum Order {
/**
* Upgrade order is download.
*
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
DOWNLOAD = 1,
/**
* Upgrade order is Install.
*
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
INSTALL = 2,
/**
* Upgrade order is download and install.
*
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
DOWNLOAD_AND_INSTALL = 3,
/**
* Upgrade order is apply.
*
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
APPLY = 4,
/**
* Upgrade order is install and apply.
*
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
INSTALL_AND_APPLY = 6
}
/**
* Enumerates upgrade status.
*
* @enum { number }
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
export enum UpgradeStatus {
/**
* Upgrade status is waiting for download.
*
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
WAITING_DOWNLOAD = 20,
/**
* Upgrade status is downloading.
*
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
DOWNLOADING = 21,
/**
* Upgrade status is download paused.
*
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
DOWNLOAD_PAUSED = 22,
/**
* Upgrade status is download failed.
*
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
DOWNLOAD_FAIL = 23,
/**
* Upgrade status is waiting for installation.
*
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
WAITING_INSTALL = 30,
/**
* Upgrade status is upgrading.
*
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
UPDATING = 31,
/**
* Upgrade status is waiting for applying the update.
*
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
WAITING_APPLY = 40,
/**
* Upgrade status is applying the update.
*
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
APPLYING = 41,
/**
* Upgrade status is update succeeded.
*
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
UPGRADE_SUCCESS = 50,
/**
* Upgrade status is update failed.
*
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
UPGRADE_FAIL = 51
}
/**
* Enumerates event classify.
*
* @enum { number }
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
export enum EventClassify {
/**
* Event classify is task event.
*
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
TASK = 0x01000000
}
/**
* Enumerates event id.
*
* @enum { number }
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
export enum EventId {
/**
* Event id is task event.
*
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
EVENT_TASK_BASE = EventClassify.TASK,
/**
* Event id is task received.
*
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
EVENT_TASK_RECEIVE,
/**
* Event id is task cancelled.
*
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
EVENT_TASK_CANCEL,
/**
* Event id is waiting for download.
*
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
EVENT_DOWNLOAD_WAIT,
/**
* Event id is download started.
*
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
EVENT_DOWNLOAD_START,
/**
* Event id is download progress update.
*
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
EVENT_DOWNLOAD_UPDATE,
/**
* Event id is download paused.
*
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
EVENT_DOWNLOAD_PAUSE,
/**
* Event id is download resumed.
*
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
EVENT_DOWNLOAD_RESUME,
/**
* Event id is download succeeded.
*
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
EVENT_DOWNLOAD_SUCCESS,
/**
* Event id is download failed.
*
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
EVENT_DOWNLOAD_FAIL,
/**
* Event id is waiting for update.
*
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
EVENT_UPGRADE_WAIT,
/**
* Event id is update started.
*
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
EVENT_UPGRADE_START,
/**
* Event id is update in progress.
*
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
EVENT_UPGRADE_UPDATE,
/**
* Event id is waiting for applying the update.
*
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
EVENT_APPLY_WAIT,
/**
* Event id is applying the update.
*
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
EVENT_APPLY_START,
/**
* Event id is update succeeded.
*
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
EVENT_UPGRADE_SUCCESS,
/**
* Event id is update failed.
*
* @syscap SystemCapability.Update.UpdateService
* @systemapi hide for inner use.
* @since 9
*/
EVENT_UPGRADE_FAIL
}
}
export default update;