HarmonyOS NEXT - 验证应用数据迁移

应用沙箱数据准备

 

在开发的过程中，当开发者完成所需适配流程后，可导入提前准备好的APK应用沙箱数据，自验证HarmonyOS应用数据迁移适配结果。

在HarmonyOS应用适配完成并上架到华为应用市场之后，开发者仍需要将终端设备从HarmonyOS升级到HarmonyOS NEXT，端到端验证应用数据迁移结果。

自验证需要使用到APK应用沙箱数据。

1. 请自行构造APK应用沙箱数据，并将构造好的APK应用沙箱数据按指定格式打包成“{APK包名}.zip”。

   APK应用沙箱目录	{APK包名}.zip目录
   /data/user_de/{userId}/{APK包名}/	{APK包名}/de
   /data/user/{userId}/{APK包名}/	{APK包名}/ce
   /data/media/{userId}/Android/data/{APK包名}/	{APK包名}/A/data
   /data/media/{userId}/Android/obb/{APK包名}/	{APK包名}/A/obb

   如下图所示，打包好的“{APK包名}.zip”解压后，要满足包含一个“APK包名”根目录，根目录下包含对应沙箱目录文件夹。

   

   

2. 将打包好的“{APK包名}.zip”推送到外部存储设备（U盘或者移动硬盘），连接终端设备和外部存储设备。

   说明

   当前终端设备支持识别NTFS格式的外部存储设备，请使用NTFS格式的外部存储设备连接终端设备。

3. 在终端设备中，打开“文件管理”应用，长按选中外部存储设备中的“{APK包名}.zip”。

   

    

   

4. 单击“复制”按钮，将数据复制到文件管理器的“下载”目录下，作为后续自验证的测试数据源。

   

    

   

HarmonyOS NEXT上模拟验证应用数据迁移 

在应用沙箱数据准备好之后，开发者需要先完成所需适配流程，再模拟验证应用数据迁移。

1. 安装目标HarmonyOS应用到终端设备。

   注意

   “迁移调试”工具“205.0.0.110”之前的版本，仅支持调试release签名的应用。

   从“205.0.0.110”版本开始，“迁移调试”工具仅支持调试debug签名的应用。请开发者升级到最新版本，并使用debug签名的包验证。

   “迁移调试”工具版本查看方式：设置 > 应用和元服务 > MigrateTool > 版本

2. 打开迁移调试工具。迁移调试工具图标如下图所示：

   

3. 在“迁移工具”应用的首页，开发者通过单击“选择”按钮进入设备文件管理界面。

   

4. 在设备文件管理界面，单击“浏览”按钮，进入浏览手机内部存储界面。单击“我的手机”，根据之前导入数据的路径，进入手机存储的相应路径，选择需要导入的APK应用数据zip包。

   

    

   

5. 单击需要导入的APK应用数据zip包后，会返回“迁移调试”工具首页，已选择的需要导入的APK应用数据会显示在第一栏中。

   

6. 选择好需要导入的APK应用数据后，单击“请输入应用包名”。

   

7. 输入需要验证的目标HarmonyOS应用包名，目标HarmonyOS应用会显示在“迁移调试”工具首页的第二栏中。

   

    

   

8. 选择需要导入的APK数据和目标HarmonyOS应用后，单击“启动迁移”按钮，开始模拟数据迁移，页面切换为数据优化界面，应用数据迁移的进度在数据迁移进度条中显示。

   

    

   

9. 应用数据迁移完成之后，数据迁移进度条上方显示“已优化完成”，进度更新为100%。数据迁移成功的情况下，界面中无异常提示。单击“完成”按钮，切换回“迁移调试”工具首页，在下方的“迁移日志”版块中显示详细迁移信息。result字段表示数据迁移结果，costTime字段表示数据迁移时长（单位ms）。

   说明

   此处的数据迁移成功，仅表示“备份恢复框架”接入成功，APK应用的数据成功迁移到“备份恢复框架”需要的指定目录。开发者需要通过从应用的沙箱中获取数据并解析，判断应用适配“备份恢复框架”的结果。

   

    

   

10. 数据迁移失败的情况下，应用图标上方的状态显示“优化失败”。单击“完成”按钮，切换回“迁移工具”应用首页，在下方的“迁移日志”版块中显示详细迁移信息。result字段表示数据迁移结果，costTime字段表示数据迁移时长（单位ms）。

    

     

    

 端到端验证

 

应用适配完成并上架到华为应用市场之后，开发者需要模拟终端用户将终端设备从HarmonyOS升级到HarmonyOS NEXT的场景，端到端验证应用数据迁移结果。

1. 当前开发者持有的终端设备为HarmonyOS NEXT。在应用适配完成并上架到华为应用市场之后，开发者需要联系华为方技术支撑人员提供版本，支持开发者将终端设备从HarmonyOS NEXT回退到HarmonyOS。系统回退的入口为：设置 > 通用 > 开发者模式 > 系统回退。
2. 将终端设备回退到HarmonyOS后，需要预置APK应用的数据。在数据预置完成后，开发者需要联系华为方技术支撑人员提供版本，支持开发者将终端设备从HarmonyOS升级到HarmonyOS NEXT。系统更新的入口为：设置 > 系统和更新 > 软件更新。
3. 终端设备成功从HarmonyOS升级到HarmonyOS NEXT，走过开机向导界面后，开始执行应用数据迁移。开发者请在应用数据迁移结束后，验证应该数据迁移的结果。

常见问题与异常处理 

 

无法获取已安装HarmonyOS应用列表

问题现象

单击“请选择HarmonyOS应用包名”按钮，已安装HarmonyOS应用列表未显示。

可能原因

迁移调试应用需要读取已安装应用列表的权限，在首次使用该工具时，单击了“禁止”按钮，迁移调试应用没有访问已安装HarmonyOS应用列表的权限。

解决方法

将终端设备恢复出厂设置。首次使用迁移调试应用时，单击“允许”按钮，授予迁移调试应用读取已安装应用列表的权限。

应用数据迁移暂停

问题现象

在数据优化界面，应用数据迁移暂停。

可能原因

应用数据迁移的过程中需要使用到网络，当前终端设备网络不可用，导致数据迁移暂停。

解决方法

单击“去桌面”按钮，进入桌面后连接网络，终端设备网络可用后，恢复应用数据迁移。

应用数据迁移执行十五分钟后失败

问题现象

应用数据迁移执行十五分钟后显示失败。

可能原因

单个应用数据迁移执行超过十五分钟，超过设定的单个应用最长数据迁移时间，任务执行失败。

解决方法

请优化应用BackupExtensionAbility的代码实现，在十五分钟内完成应用数据迁移。

说明

已接入“数据迁移框架”的应用完成数据迁移后，才可以被消费者使用。尽可能快的完成应用数据迁移，可以带给消费者更好的体验。