HarmonyOS 鸿蒙Next中通知消息点击跳转

当发布通知时，如果期望用户可以通过点击通知栏拉起目标应用组件或发布公共事件，可以通过Ability Kit申请WantAgent封装至通知消息中。

1. 代码中申请通知权限：

enableNotifications() {
  let requestEnableNotificationCallback = (err: BusinessError): void => {
    if (err) {
      hilog.error(0x0000, 'testTag',
        `[ANS] requestEnableNotification failed, code is ${err.code}, message is ${err.message}`);
    } else {
      hilog.info(0x0000, 'testTag', `[ANS] requestEnableNotification success`);
    }
  };
  notificationManager.requestEnableNotification(this.context, requestEnableNotificationCallback);
}

1. 创建WantAgentInfo信息并填写需要拉起的应用bundleName和abilityName（应用只能设置自己应用的bundleName和abilityName），然后构造NotificationRequest对象并发布通知：

Button('点击发送通知消息').onClick(() => {
  let wantAgentObj: WantAgent;
  let wantAgentInfo: wantAgent.WantAgentInfo = {
    wants: [
      {
        deviceId: '',
        bundleName: 'com.example.ir_wantagent',
        abilityName: 'EntryAbility',
        action: '',
        entities: [],
        uri: '',
        parameters: {
          targetPage: 'Index2' // 添加目标页面参数
        }
      }
    ],
    actionType: wantAgent.OperationType.START_ABILITY,
    requestCode: 0,
    wantAgentFlags: [wantAgent.WantAgentFlags.CONSTANT_FLAG]
  };
  wantAgent.getWantAgent(wantAgentInfo, (err: BusinessError, data: WantAgent) => {
    if (err) {
      hilog.error(DOMAIN_NUMBER, TAG, `Failed to get want agent. Code is ${err.code}, message is ${err.message}`);
      return;
    }
    hilog.info(DOMAIN_NUMBER, TAG, 'Succeeded in getting want agent.');
    wantAgentObj = data;
    // 构造NotificationRequest对象
    let notificationRequest: notificationManager.NotificationRequest = {
      content: {
        notificationContentType: notificationManager.ContentType.NOTIFICATION_CONTENT_BASIC_TEXT,
        normal: {
          title: 'Test_Title',
          text: 'Test_Text',
          additionalText: 'Test_AdditionalText',
        },
      },
      id: 6,
      label: 'TEST',
      // wantAgentObj使用前需要保证已被赋值（即步骤3执行完成）
      wantAgent: wantAgentObj,
    }
    notificationManager.publish(notificationRequest, (err: BusinessError) => {
      if (err) {
        hilog.error(DOMAIN_NUMBER, TAG,
          `Failed to publish notification. Code is ${err.code}, message is ${err.message}`);
        return;
      }
      hilog.info(DOMAIN_NUMBER, TAG, 'Succeeded in publishing notification.');
    });
  });
})

1. 在EntryAbility.ets文件中添加方法实现目标UIAbility热启动和目标UIAbility冷启动用来获取点击消息通知后的WantAgentInfo信息并实现跳转指定页面。

• 热启动代码，在应用已启动的情况下实现点击消息通知后会从应用当前所在页面跳转到指定页面：

// 热启动
onNewWant(want: Want, launchParam: AbilityConstant.LaunchParam): void {
  // 通过want.parameters获取参数
  const targetPage = want.parameters?.targetPage;
  console.info(`onNewWant Received parameter: ${targetPage}`)
  // 根据参数执行逻辑（例如跳转页面）
  if (targetPage === 'Index2') {
    // 跳转到Index2页面
    router.pushUrl({
      url: 'pages/Index2'
    });
  }
}

• 冷启动代码，实现点击消息通知会启动应用并直接跳转指定页面：

// 冷启动
onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void {
  this.context.getApplicationContext().setColorMode(ConfigurationConstant.ColorMode.COLOR_MODE_NOT_SET);
  hilog.info(0x0000, 'testTag', '%{public}s', 'Ability onCreate');
  this.funcAbilityWant = want;
}
onWindowStageCreate(windowStage: window.WindowStage): void {
  let url = 'pages/Index';
  if (this.funcAbilityWant?.parameters?.targetPage === 'Index2') {
    url = 'pages/Index2'; // 需要自行新增页面Index2来模拟跳转动作
  }
  console.info(`url:${url}`)
  windowStage.loadContent(url, (err) => {
    if (err.code) {
      hilog.error(0x0000, 'testTag', 'Failed to load the content. Cause: %{public}s', JSON.stringify(err) ?? '');
      return;
    }
    hilog.info(0x0000, 'testTag', 'Succeeded in loading the content.');
  });
}

1. 新增Index2页面的步骤：右键工程中的Pages文件夹，然后选择New，接着点击Page最后点击New Page，输入Index2即可创建Page页面文件Index2.ets。

2. 模拟点击消息跳转页面步骤：

• 冷启动：发送消息后，在多任务页面终止应用，再点击消息实现跳转应用指定页面Index2。
• 热启动：发送消息后，将应用返回后台，再点击消息实现跳转应用指定页面Index2。