环境要求
开发者需要通过OTA升级的形式,将终端设备升级到HarmonyOS NEXT Developer Beta1。
工具要求
工具 | 版本 | 说明 |
---|---|---|
“迁移调试”工具 | 205.0.0.115 | 模拟验证数据迁移 |
DevEco Studio | DevEco Studio NEXT Developer Beta1 | 请参考: DevEco Studio使用指南 |
Compatible SDK | 5.0.0(12) | 请参考: 版本说明 |
创建新工程
本章节从创建新工程开始,指导开发者接入“备份恢复框架”,已经创建工程的开发者可以跳过本节。
- 打开DevCco Studio编译器,在菜单栏点击File**** >**** New**** >**** Create Project,创建新工程。
- 在创建工程界面选择创建Empty Ability工程,单击Next按钮进入下一步。
- 在Configure Your Project界面,根据开发者的需求,创建自己的工程,Compatible SDK栏请选择:5.0.0(12)。选择完毕之后,点击Finish按钮完成工程创建。
- 工程创建成功之后进入如下界面。
BackupExtensionAbility的实现
开发者可以在BackupExtension.ts文件中自定义类继承BackupExtensionAbility,通过重写其中的onBackup和onRestore方法,自定义应用数据的转换和迁移。终端设备从HarmonyOS升级到HarmonyOS NEXT数据迁移场景中,onRestore回调接口中的参数bundleVersion.name的前缀为“0.0.0.0”。下面的代码展示了一个空实现,应用的数据转换和迁移逻辑,请在指定位置填充实现。
import { BackupExtensionAbility, BundleVersion } from '@kit.CoreFileKit';
const TAG = `BackupExtensionAbility`;
/**
* serviceExt进程入口
*/
export default class BackupExtension extends BackupExtensionAbility {
onBackup () {
console.log(TAG,`onBackup ok`);
}
/**
* 数据恢复处理接口。接口是同步接口,其内部所有的异步操作请进行同步等待。
*
* @param bundleVers