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

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

一、前言

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

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

1. 冷啟動（Cold Start）

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

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

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

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

2. 熱啟動（Warm Start）

應(yīng)用在后臺運行時被重新激活（如切換任務(wù)或接收新事件）。

一般和冷啟動處理是一對兒，處理邏輯也和冷啟動一致。只不過此時應(yīng)用從onNewWant函數(shù)跳進(jìn)來。時機(jī)也是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; // 獲取目標(biāo)頁面標(biāo)識（funA/funB）
    }
  }

  // 加載頁面
  onWindowStageCreate(windowStage: window.WindowStage) {
    let targetPage = 'pages/Index'; // 默認(rèn)頁面
    switch (this.selectPage) {
      case 'funA': targetPage = 'pages/FunA'; break;
      case 'funB': targetPage = 'pages/FunB'; break;
    }
    windowStage.loadContent(targetPage); // 加載對應(yīng)頁面
  }
}

二、UIAbility備份恢復(fù)：保障異常終止后的狀態(tài)延續(xù)

應(yīng)用因系統(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. 恢復(fù)數(shù)據(jù)

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

onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) {
  if (want.parameters?.editorContent) {
    this.editor.setText(want.parameters.editorContent as string); // 恢復(fù)文本
    this.router.navigateTo(want.parameters.currentPage as string); // 恢復(fù)頁面路由
  }
}

注意

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

三、應(yīng)用接續(xù)（Continuation）：跨設(shè)備任務(wù)無縫遷移

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

1. 配置可遷移能力

在module.json5中設(shè)置continuable: true：

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

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

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

onContinue(wantParam: Record< string, Object >): OnContinueResult {
  // 校驗?zāi)繕?biāo)設(shè)備版本
  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. 目標(biāo)端（接收設(shè)備）恢復(fù)

冷啟動時通過onCreate恢復(fù)，熱啟動時通過onNewWant恢復(fù)：

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

注意

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

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

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

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

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

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

審核編輯 黃宇