##鸿蒙开发能力 ##HarmonyOS SDK应用服务##鸿蒙游戏类应用 （游戏# 一、前言 本文是鸿蒙中的UIAbility详解系列的最终章。主要针对UIAbility的冷启动和热启动，对于want数据的处理。UIAbility的备份恢复，UIAbility的接续等高级功能的概念和使用讲解。

二、UIAbility启动模式：冷启动与热启动的Want数据处理

1. 冷启动（Cold Start） 应用首次启动或被系统完全终止后重新创建。
   冷启动，应用会从onCreate函数中进入，通过want参数，我们可以处理其中携带的信息。像applink就是uri，deeplink就是parameters?.deepLink，还有推送等。 核心逻辑很简单，根据want中对应需要处理的字段信息，进行逻辑处理（跳转目标页面，数据和业务处理等）。 onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) { const deepLinkData = want.parameters?.deepLink; // 解析深层链接参数 this.initData(deepLinkData); }
2. 热启动（Warm Start） 应用在后台运行时被重新激活（如切换任务或接收新事件）。
   一般和冷启动处理是一对儿，处理逻辑也和冷启动一致。只不过此时应用从onNewWant函数跳进来。时机也是App已经创建了，此时又被激活。 onNewWant(want: Want, launchParam: AbilityConstant.LaunchParam) { if (launchParam.launchReason === AbilityConstant.LaunchReason.NEW_WANT) { const updateData = want.parameters?.updateData; // 解析热启动参数 this.refreshUI(updateData); } }

总结：冷热启动区别对比 特性 冷启动 热启动 触发条件 首次启动/进程终止后重启 从后台唤醒/接收新Want 生命周期入口 onCreate onNewWant（单实例） 页面栈处理 重建页面栈 恢复现有页面栈 Want参数来源 启动时指定（如图标点击、链接） 运行中动态传入（如跨Ability调用） 3. 源码示例 // EntryAbility.ets export default class EntryAbility extends UIAbility { private selectPage: string = '';

// 冷启动时触发 onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) { this.parseParams(want); // 解析参数 }

// 热启动时触发 onNewWant(want: Want, launchParam: AbilityConstant.LaunchParam) { this.parseParams(want); // 解析参数 if (this.currentWindowStage) { this.onWindowStageCreate(this.currentWindowStage); // 重新加载页面 } }

// 解析参数逻辑 private parseParams(want: Want) { if (want.parameters?.params) { const params = JSON.parse(want.parameters.params as string); this.selectPage = params.targetPage; // 获取目标页面标识（funA/funB） } }

// 加载页面 onWindowStageCreate(windowStage: window.WindowStage) { let targetPage = 'pages/Index'; // 默认页面 switch (this.selectPage) { case 'funA': targetPage = 'pages/FunA'; break; case 'funB': targetPage = 'pages/FunB'; break; } windowStage.loadContent(targetPage); // 加载对应页面 } }

二、UIAbility备份恢复：保障异常终止后的状态延续 应用因系统资源不足被后台终止时，自动保存状态。 下次启动时还原数据（如编辑中的内容、页面位置）。

1. 启用备份功能 在onCreate中调用setRestoreEnabled(true)：
   export default class EntryAbility extends UIAbility { onCreate() { this.context.setRestoreEnabled(true); // 初始化时启用备份 } }
2. 保存自定义数据 重写onSaveState方法，通过WantParams存储数据：
   onSaveState(state: AbilityConstant.StateType, wantParams: Record<string, Object>) { wantParams["editorContent"] = this.editor.getText(); // 保存编辑内容 wantParams["currentPage"] = this.router.getCurrentPage(); // 保存页面路由 return AbilityConstant.OnSaveResult.ALL_AGREE; }
3. 恢复数据 在onCreate或onNewWant中解析参数：
   onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) { if (want.parameters?.editorContent) { this.editor.setText(want.parameters.editorContent as string); // 恢复文本 this.router.navigateTo(want.parameters.currentPage as string); // 恢复页面路由 } } 注意
4. 数据限制：单次备份最大200KB，存储时效7天，重启设备不保留。
5. 适用场景：临时数据（如未保存的表单）、页面状态（如滚动位置），不建议存储敏感数据。
6. 性能优化：避免在onSaveState中执行耗时操作，优先存储关键状态。

三、应用接续（Continuation）：跨设备任务无缝迁移 将当前页面状态、路由信息迁移至另一设备（如手机→平板）。 支持按场景开启/关闭迁移（如仅在编辑页允许迁移）。 小数据通过wantParam传输（≤100KB），大数据使用分布式数据对象（DDO）。

1. 配置可迁移能力 在module.json5中设置continuable: true：
   { "abilities": [ { "name": "EditorAbility", "continuable": true // 启用跨设备迁移 } ] }

2. 源端（发起迁移设备）实现 onContinue回调：保存数据、校验兼容性、决定是否迁移。
   onContinue(wantParam: Record<string, Object>): OnContinueResult { // 校验目标设备版本 if (wantParam.version < MIN_SUPPORT_VERSION) return MISMATCH;

   // 保存编辑内容 wantParam["editorData"] = this.editor.getData();

   // 动态控制迁移状态（如仅在编辑页允许迁移） if (this.currentPage !== 'EditorPage') return REJECT;

   return AGREE; }

3. 目标端（接收设备）恢复 冷启动时通过onCreate恢复，热启动时通过onNewWant恢复：
   onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) { if (launchParam.launchReason === CONTINUATION) { const editorData = want.parameters?.editorData; this.editor.setData(editorData); // 恢复数据 this.context.restoreWindowStage(); // 自动恢复页面栈 } } 注意

4. 针对动态开关迁移：通过setMissionContinueState控制（如在非编辑页禁用）：
   // 在非编辑页关闭迁移 this.context.setMissionContinueState(AbilityConstant.ContinueState.INACTIVE);

5. 针对自定义页面栈：关闭自动恢复，手动指定目标页面：
   onContinue(wantParam) { wantParam[wantConstant.Params.SUPPORT_CONTINUE_PAGE_STACK_KEY] = false; // 禁用自动恢复 wantParam["targetPage"] = "SummaryPage"; // 自定义目标页面 }

   3. 针对大数据迁移：使用分布式数据对象（DDO）同步文件或大文本：
      // 源端创建DDO并保存 const ddo = distributedDataObject.create(this.context, largeData); wantParam["ddoSessionId"] = ddo.genSessionId(); // 传递会话ID至目标端