【HarmonyOS 5】鴻蒙中的UIAbility詳解（三）

##鴻蒙開發(fā)能力 ##HarmonyOS SDK應用服務##鴻蒙金融類應用 （金融理財#

一、前言

本文是鴻蒙中的UIAbility詳解系列的最終章。主要針對UIAbility的冷啟動和熱啟動，對于want數(shù)據(jù)的處理。UIAbility的備份恢復，UIAbility的接續(xù)等高級功能的概念和使用講解。

二、UIAbility啟動模式：冷啟動與熱啟動的Want數(shù)據(jù)處理

1. 冷啟動（Cold Start）

應用首次啟動或被系統(tǒng)完全終止后重新創(chuàng)建。

冷啟動，應用會從onCreate函數(shù)中進入，通過want參數(shù)，我們可以處理其中攜帶的信息。像applink就是uri，deeplink就是parameters?.deepLink，還有推送等。

核心邏輯很簡單，根據(jù)want中對應需要處理的字段信息，進行邏輯處理（跳轉(zhuǎn)目標頁面，數(shù)據(jù)和業(yè)務處理等）。

onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) {
  const deepLinkData = want.parameters?.deepLink; // 解析深層鏈接參數(shù)
  this.initData(deepLinkData);
}

2. 熱啟動（Warm Start）

應用在后臺運行時被重新激活（如切換任務或接收新事件）。

一般和冷啟動處理是一對兒，處理邏輯也和冷啟動一致。只不過此時應用從onNewWant函數(shù)跳進來。時機也是App已經(jīng)創(chuàng)建了，此時又被激活。

onNewWant(want: Want, launchParam: AbilityConstant.LaunchParam) {
  if (launchParam.launchReason === AbilityConstant.LaunchReason.NEW_WANT) {
    const updateData = want.parameters?.updateData; // 解析熱啟動參數(shù)
    this.refreshUI(updateData);
  }
}

總結(jié)：冷熱啟動區(qū)別對比

3. 源碼示例

// EntryAbility.ets
export default class EntryAbility extends UIAbility {
  private selectPage: string = '';

  // 冷啟動時觸發(fā)
  onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) {
    this.parseParams(want); // 解析參數(shù)
  }

  // 熱啟動時觸發(fā)
  onNewWant(want: Want, launchParam: AbilityConstant.LaunchParam) {
    this.parseParams(want); // 解析參數(shù)
    if (this.currentWindowStage) {
      this.onWindowStageCreate(this.currentWindowStage); // 重新加載頁面
    }
  }

  // 解析參數(shù)邏輯
  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備份恢復：保障異常終止后的狀態(tài)延續(xù)

應用因系統(tǒng)資源不足被后臺終止時，自動保存狀態(tài)。
下次啟動時還原數(shù)據(jù)（如編輯中的內(nèi)容、頁面位置）。

1. 啟用備份功能

在onCreate中調(diào)用setRestoreEnabled(true)：

export default class EntryAbility extends UIAbility {
  onCreate() {
    this.context.setRestoreEnabled(true); // 初始化時啟用備份
  }
}

2. 保存自定義數(shù)據(jù)

重寫onSaveState方法，通過WantParams存儲數(shù)據(jù)：

onSaveState(state: AbilityConstant.StateType, wantParams: Record< string, Object >) {
  wantParams["editorContent"] = this.editor.getText(); // 保存編輯內(nèi)容
  wantParams["currentPage"] = this.router.getCurrentPage(); // 保存頁面路由
  return AbilityConstant.OnSaveResult.ALL_AGREE;
}

3. 恢復數(shù)據(jù)

在onCreate或onNewWant中解析參數(shù)：

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. 數(shù)據(jù)限制 ：單次備份最大200KB，存儲時效7天，重啟設備不保留。
2. 適用場景 ：臨時數(shù)據(jù)（如未保存的表單）、頁面狀態(tài)（如滾動位置）， 不建議存儲敏感數(shù)據(jù) 。
3. 性能優(yōu)化 ：避免在onSaveState中執(zhí)行耗時操作，優(yōu)先存儲關(guān)鍵狀態(tài)。

三、應用接續(xù)（Continuation）：跨設備任務無縫遷移

將當前頁面狀態(tài)、路由信息遷移至另一設備（如手機→平板）。
支持按場景開啟/關(guān)閉遷移（如僅在編輯頁允許遷移）。
小數(shù)據(jù)通過wantParam傳輸（≤100KB），大數(shù)據(jù)使用分布式數(shù)據(jù)對象（DDO）。

1. 配置可遷移能力

在module.json5中設置continuable: true：

{
  "abilities": [
    {
      "name": "EditorAbility",
      "continuable": true // 啟用跨設備遷移
    }
  ]
}

2. 源端（發(fā)起遷移設備）實現(xiàn)

onContinue回調(diào)：保存數(shù)據(jù)、校驗兼容性、決定是否遷移。

onContinue(wantParam: Record< string, Object >): OnContinueResult {
  // 校驗目標設備版本
  if (wantParam.version < MIN_SUPPORT_VERSION) return MISMATCH;
  
  // 保存編輯內(nèi)容
  wantParam["editorData"] = this.editor.getData();
  
  // 動態(tài)控制遷移狀態(tài)（如僅在編輯頁允許遷移）
  if (this.currentPage !== 'EditorPage') return REJECT;
  
  return AGREE;
}

4. 目標端（接收設備）恢復

冷啟動時通過onCreate恢復，熱啟動時通過onNewWant恢復：

onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) {
  if (launchParam.launchReason === CONTINUATION) {
    const editorData = want.parameters?.editorData;
    this.editor.setData(editorData); // 恢復數(shù)據(jù)
    this.context.restoreWindowStage(); // 自動恢復頁面棧
  }
}

注意

1. 針對動態(tài)開關(guān)遷移 ：通過setMissionContinueState控制（如在非編輯頁禁用）：

// 在非編輯頁關(guān)閉遷移
this.context.setMissionContinueState(AbilityConstant.ContinueState.INACTIVE);

2. 針對自定義頁面棧 ：關(guān)閉自動恢復，手動指定目標頁面：

onContinue(wantParam) {
  wantParam[wantConstant.Params.SUPPORT_CONTINUE_PAGE_STACK_KEY] = false; // 禁用自動恢復
  wantParam["targetPage"] = "SummaryPage"; // 自定義目標頁面
}

3. 針對大數(shù)據(jù)遷移 ：使用分布式數(shù)據(jù)對象（DDO）同步文件或大文本：

// 源端創(chuàng)建DDO并保存
const ddo = distributedDataObject.create(this.context, largeData);
wantParam["ddoSessionId"] = ddo.genSessionId(); // 傳遞會話ID至目標端

審核編輯 黃宇