【HarmonyOS 5】鸿蒙中的UIAbility详解（三）

原创

GeorgeGcs

发布于 2025-06-01 01:16:58

3240

文章被收录于专栏：HarmonyOS知识集合HarmonyOS知识集合

【HarmonyOS 5】鸿蒙中的UIAbility详解（三）

一、前言

本文是鸿蒙中的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); // 恢复页面路由
  }
}

注意

1. 数据限制：单次备份最大200KB，存储时效7天，重启设备不保留。

2. 适用场景：临时数据（如未保存的表单）、页面状态（如滚动位置），不建议存储敏感数据。

3. 性能优化：避免在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;
  }4. 目标端（接收设备）恢复冷启动时通过

注意

1. 针对动态开关迁移：通过setMissionContinueState控制（如在非编辑页禁用）：

  // 在非编辑页关闭迁移
  this.context.setMissionContinueState(AbilityConstant.ContinueState.INACTIVE);

3. 针对大数据迁移：使用分布式数据对象（DDO）同步文件或大文本：

  // 源端创建DDO并保存
  const ddo = distributedDataObject.create(this.context, largeData);
  wantParam["ddoSessionId"] = ddo.genSessionId(); // 传递会话ID至目标端

原创声明：本文系作者授权腾讯云开发者社区发表，未经许可，不得转载。

如有侵权，请联系 cloudcommunity@tencent.com 删除。

harmonyos

原创声明：本文系作者授权腾讯云开发者社区发表，未经许可，不得转载。

如有侵权，请联系 cloudcommunity@tencent.com 删除。

harmonyos

登录后参与评论

0 条评论

热度

【HarmonyOS 5】鸿蒙中的UIAbility详解（三）

【HarmonyOS 5】鸿蒙中的UIAbility详解（三）

【HarmonyOS 5】鸿蒙中的UIAbility详解（三）

一、前言

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

1. 冷启动（Cold Start）

2. 热启动（Warm Start）

总结：冷热启动区别对比

3. 源码示例

二、UIAbility备份恢复：保障异常终止后的状态延续

1. 启用备份功能

2. 保存自定义数据

3. 恢复数据

注意

三、应用接续（Continuation）：跨设备任务无缝迁移

1. 配置可迁移能力

2. 源端（发起迁移设备）实现

注意

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐