使用router事件跳轉(zhuǎn)到指定UIAbility

在卡片中使用postCardAction接口的router能力，能夠快速拉起卡片提供方應(yīng)用的指定UIAbility，因此UIAbility較多的應(yīng)用往往會(huì)通過(guò)卡片提供不同的跳轉(zhuǎn)按鈕，實(shí)現(xiàn)一鍵直達(dá)的效果。例如相機(jī)卡片，卡片上提供拍照、錄像等按鈕，點(diǎn)擊不同按鈕將拉起相機(jī)應(yīng)用的不同UIAbility，從而提升用戶(hù)的體驗(yàn)。

通常使用按鈕控件來(lái)實(shí)現(xiàn)頁(yè)面拉起，示例代碼如下：

• 在卡片頁(yè)面中布局兩個(gè)按鈕，點(diǎn)擊其中一個(gè)按鈕時(shí)調(diào)用postCardAction向指定UIAbility發(fā)送router事件，并在事件內(nèi)定義需要傳遞的內(nèi)容。

  @Entry
  @Component
  struct WidgetCard {
    build() {
      Column() {
        Button('功能A')
          .margin('20%')
          .onClick(() => {
            console.info('Jump to EntryAbility funA');
            postCardAction(this, {
              'action': 'router',
              'abilityName': 'EntryAbility', // 只能跳轉(zhuǎn)到當(dāng)前應(yīng)用下的UIAbility
              'params': {
                'targetPage': 'funA' // 在EntryAbility中處理這個(gè)信息
              }
            });
          })
  
        Button('功能B')
          .margin('20%')
          .onClick(() => {
            console.info('Jump to EntryAbility funB');
            postCardAction(this, {
              'action': 'router',
              'abilityName': 'EntryAbility', // 只能跳轉(zhuǎn)到當(dāng)前應(yīng)用下的UIAbility
              'params': {
                'targetPage': 'funB' // 在EntryAbility中處理這個(gè)信息
              }
            });
          })
      }
      .width('100%')
      .height('100%')
    }
  }

• 在UIAbility中接收router事件并獲取參數(shù)，根據(jù)傳遞的params不同，選擇拉起不同的頁(yè)面。

  import UIAbility from '@ohos.app.ability.UIAbility';
  import window from '@ohos.window';
  
  let selectPage = "";
  let currentWindowStage = null;
  
  export default class CameraAbility extends UIAbility {
    // 如果UIAbility第一次啟動(dòng)，在收到Router事件后會(huì)觸發(fā)onCreate生命周期回調(diào)
    onCreate(want, launchParam) {
      // 獲取router事件中傳遞的targetPage參數(shù)
      console.info("onCreate want:" + JSON.stringify(want));
      if (want.parameters.params !== undefined) {
        let params = JSON.parse(want.parameters.params);
        console.info("onCreate router targetPage:" + params.targetPage);
        selectPage = params.targetPage;
      }
    }
    // 如果UIAbility已在后臺(tái)運(yùn)行，在收到Router事件后會(huì)觸發(fā)onNewWant生命周期回調(diào)
    onNewWant(want, launchParam) {
      console.info("onNewWant want:" + JSON.stringify(want));
      if (want.parameters.params !== undefined) {
        let params = JSON.parse(want.parameters.params);
        console.info("onNewWant router targetPage:" + params.targetPage);
        selectPage = params.targetPage;
      }
      if (currentWindowStage != null) {
        this.onWindowStageCreate(currentWindowStage);
      }
    }
  
    onWindowStageCreate(windowStage: window.WindowStage) {
      let targetPage;
      // 根據(jù)傳遞的targetPage不同，選擇拉起不同的頁(yè)面
      switch (selectPage) {
        case 'funA':
          targetPage = 'pages/FunA';
          break;
        case 'funB':
          targetPage = 'pages/FunB';
          break;
        default:
          targetPage = 'pages/Index';
      }
      if (currentWindowStage === null) {
        currentWindowStage = windowStage;
      }
      windowStage.loadContent(targetPage, (err, data) => {
        if (err && err.code) {
          console.info('Failed to load the content. Cause: %{public}s', JSON.stringify(err));
          return;
        }
      });
    }
  };