@ohos.application.BackupExtensionAbility (备份恢复扩展能力)
BackupExtensionAbility模块提供备份恢复服务相关扩展能力,为应用提供扩展的备份恢复能力。
说明:
本模块首批接口从API version 10开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
本模块接口仅可在Stage模型下使用。
导入模块
import BackupExtension from '@ohos.application.BackupExtensionAbility';
BundleVersion
恢复时所需要的版本信息,开发者可根据配置的版本号来判断本次恢复时的应用版本数据。
系统能力:SystemCapability.FileManagement.StorageService.Backup
名称 | 类型 | 必填 | 说明 |
---|---|---|---|
code | number | 是 | 应用的版本号。 |
name | string | 是 | 应用的版本名称。 |
BackupExtensionAbility.onBackup
onBackup(): void;
Extension生命周期回调,在执行备份数据时回调,由开发者提供扩展的备份数据的操作。
系统能力:SystemCapability.FileManagement.StorageService.Backup
示例:
class BackupExt extends BackupExtension {
async onBackup() {
console.log('onBackup');
}
}
BackupExtensionAbility.onRestore
onRestore(bundleVersion: BundleVersion): void;
Extension生命周期回调,在执行恢复数据时回调,由开发者提供扩展的恢复数据的操作。
系统能力:SystemCapability.FileManagement.StorageService.Backup
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
bundleVersion | BundleVersion | 是 | 恢复时应用数据所在的版本信息。 |
示例:
import { BundleVersion } from '@ohos.application.BackupExtensionAbility';
class BackupExt extends BackupExtension {
async onRestore(bundleVersion : BundleVersion) {
console.log(`onRestore ok ${JSON.stringify(bundleVersion)}`);
}
}