HarmonyOS 鸿蒙Next中官方的Push Kit 文档描述有错误

HarmonyOS 鸿蒙Next中官方的Push Kit 文档描述有错误 【问题描述】

官方的Push Kit文档中，关于应用在前台处理通知消息部分的文档描述存在误导开发者的问题

【问题详情】

文档中的步骤2与步骤3的文字描述如下

而实际在开发中，receiveMessage（）接口调用时如果需要触发onMessage回调，则所在的UIAbility类中，action字段需要在单独的skill对象中进行配置，而不能同其他的action字段（例如：“ohos.want.action.home”）配置在同一个数组中，如下代码：

"abilities": [
      {
        "name": "EntryAbility",
        "srcEntry": "./ets/entryability/EntryAbility.ets",
        "description": "$string:EntryAbility_desc",
        "icon": "$media:layered_image",
        "label": "$string:EntryAbility_label",
        "startWindowIcon": "$media:startIcon",
        "startWindowBackground": "$color:start_window_background",
        "exported": true,
        "skills": [
          {
            "entities": [
              "entity.system.home"
            ],
            "actions": [
              "ohos.want.action.home",
            ]
          },
          {
            "actions": [
              "action.ohos.push.listener"
            ]
          }
        ]
      },
]

或者直接新建一个单独的UIAbility类而不是在EntryAbility中调用。

官方文档中并没有明确说明该情况或者说明需要新建一个单独的UIAbility类，所以容易误导开发者直接在EntryAbility中的actions中进行字段配置，导致回调既不触发也不报错。

该问题并不是个例情况，如：https://developer.huawei.com/consumer/cn/forum/topic/0201197302876522405?fid=0109140870620153026

1、建议官方可以参考进行修改

2、另外，我们发现调用receiveMessage（）后如果出现不能触发监听回调的时候，使用try catch也抓不到报错信息，还需要提供相关参数让技术老师查询报错，很麻烦，希望官方可以将报错信息提供在接口的回调当中，让catch直接捕获到。