鸿蒙开发进阶（HarmonyOS ）应用适配流程

 鸿蒙NEXT开发实战往期必看文章：
一分钟相识”纯血版！鸿蒙HarmonyOS Next应用开发！
“非常具体的” 鸿蒙HarmonyOS Next应用开发学习路线！（从零基础入门到精通）
HarmonyOS NEXT应用开发案例实践总联合（持续更新......）
HarmonyOS NEXT应用开发性能优化实践总结（持续更新......）

---

适配流程包罗：适配准备、应用适配、开发者自验证、应用上架和端到端验证。
图1 适配流程图

1. 适配准备阶段

在适配准备阶段，开发者必要分析清晰HarmonyOS中APK应用和HarmonyOS NEXT中HarmonyOS应用的数据范围和差异。
在开发之前，必要通过OTA升级的形式，将终端装备升级到HarmonyOS NEXT Developer Preview1及之后版本。
2.1 应用适配

在适配准备工作完成后，进入应用适配阶段。开发者必要在HarmonyOS应用的代码中，实现“BackupExtensionAbility”，使应用接入到“备份恢复框架”中，完成应用数据的转换和迁移。在“BackupExtensionAbility”中必要进行适配，从备份恢复目次下，加载APK应用数据，将必要迁移的数据处置惩罚后，保存到HarmonyOS应用沙箱中。
当前指导（应用数据迁移适配指导）将指导开发者在装备升级场景下接入“备份恢复框架”。更多“备份恢复框架”的资料可以参考：应用接入数据备份恢复。
注意
应用的“BackupExtensionAbility”执行完后，“备份恢复框架”会清空备份恢复目次，开发者请在应用的“BackupExtensionAbility”执行竣事前，完成全部所需数据的转换和迁移。
后续HarmonyOS应用通过访问HarmonyOS应用沙箱获取应用的数据。

备份恢复目次如下表中所示：
  备份恢复目次
  /data/storage/el1/base/.backup/restore/{APK包名}/de/
  /data/storage/el2/base/.backup/restore/{APK包名}/ce/
  /data/storage/el2/base/.backup/restore/{APK包名}/A/data/
  /data/storage/el2/base/.backup/restore/{APK包名}/A/obb/
  HarmonyOS应用沙箱目次请参考应用沙箱目次。
2.2 开发者自验证

HarmonyOS NEXT Developer Beta1及之后版本，厂商合作伙伴可通过IssueReporter平台提交工单，向华为方技术支持人员申请“迁移调试”工具，模拟进行数据迁移验证。公共开发者请通过“华为开发者联盟官网”->“支持”，在线提单方式获取。
HarmonyOS NEXT Developer Beta1之前版本，开发者可以通过体系内置“迁移调试”工具，模拟进行数据迁移验证。
3. 应用上架

HarmonyOS应用适配乐成后，在进行端到端验证之前，必要将HarmonyOS应用上架到华为应用市场。HarmonyOS应用上架指导请参考：发布HarmonyOS应用指导
4. 端到端验证

在HarmonyOS应用上架到华为应用市场之后，华为方技术支撑人员会为开发者推送回退版本。如果终端装备为HarmonyOS NEXT，开发者必要将终端装备回退到HarmonyOS，在HarmonyOS中使用APK应用生成数据。应用数据准备完成后，请通过OTA升级形式，将终端装备升级到华为方提供的HarmonyOS NEXT。验证HarmonyOS NEXT中的HarmonyOS应用是否乐成继续原APK应用的数据。