【FAQ】HarmonyOS鸿蒙Next SDK闭源开放能力—Push Kit

【FAQ】HarmonyOS鸿蒙Next SDK闭源开放能力—Push Kit

1. 问题描述
   升级到4.0.0.59版本后，通过pushService.getToken获取华为的token时报如下错误：Illegal application identity.

解决方案
Mate 40 Pro (NOH) 从 4.1版本升级后，会出现UDID变化，影响历史的调试签名使用，应用重新签名后即可正常运行。

1. 问题描述
   按照操作步骤，获取到了服务token，以及Authorization对应的JWT字符串。按照demo给的request body，将projectId和token替换为真实的数据，用postman post请求 这里显示成功，但是获取服务token的设备并未接收到通知或显示推送。

解决方案
请先确认应用是否请求通知授权，或者在设置中打开了通知开关，相关指导请参见：这里。

1. 问题描述
   如何获取设备永久唯一标识符？

解决方案

1. 使用AAID作为应用唯一标识符，具体请参考：这里。 请注意：AAID可被一系列操作修改。

2. 实现应用AAID不清除可以结合Asset能力实现，具体请参考： 这里

3. 问题描述：
   开发服务端推送，客户端能收到离线推送，但是推送收到的通知只能从手机顶部下拉看到，无法收到一个顶部的弹框。请问是什么原因？

解决方案：
可能原因一：
消息提醒的方式与消息类别有关，比如：
a. 服务与通讯类的提醒方式为：锁屏、铃声、振动。
b. 资讯营销类的消息提醒方式为：静默通知，仅在通知中心展示消息。
当前开发者的消息类型应该是资讯营销类的消息，消息提醒方式与消息类别的对应关系请参考：这里。

可能原因二：
如果发送的消息确实是服务与提醒类的消息 ，那么可以通过申请自分类来实现，请参考：这里。

可能原因三：
当前横幅通知只有服务与提醒类别下的“IM”和“VOIP”消息才支持，请参考：这里。

1. 问题描述：
   在这里 serviceNotification.requestSubscribeNotification接口参数中entityIds实体id列表，这个列表的数据是怎么确定的？

解决方案：
entityIds是订阅消息的模板ID，请参考消息订阅页面中的列表信息，对应文档：这里。

1. 问题描述：
   调用pushService.getToken()报错“dlopen_impl load library header failed for /system/lib64/module/hms/core/push/libpushservice.z.so”。
   大部分手机可以调用，某些设备不行。

解决方案：
通过现有日志分析，是系统底层的一个已知问题造成的。因NOH在单框架不再演进，建议伙伴切换ALN。

1. 问题描述：
   为什么配置uris会导致收不到HarmonyOS推送？如果要通过配置uris实现类似iOS的url scheme功能，该怎么做才能不影响推送？

解决方案：

1. uris和action可以同时存在。不过actions和uris不能在同一个对象中，需要在不同的对象中才可以。
2. 以首页的skills为例，下方的skills配置是可以正常收到消息的且点击也没有问题：

"skills": [
{
"entities": [
"entity.system.home"
],
"actions": [
"action.system.home",
"action.ohos.push.listener"
]
},
{
"uris": [
{
"scheme": "https",
"port":"8080",
"host": "com.xx.pushsvc.impl",
"path": "notify_detai"
}
]
}
]

1. 问题描述：
   为什么后台推送透传消息（push-type: 6），自助查询提示”其他错误，建议您联系技术支持“？

解决方案：
可能原因：服务端推送使用的token与设备保存的token不一致，大多数情况是因为您的测试机重新获取了新的token，但是他们还使用旧的推送导致的。
解决方法：重新获取最新token进行推送。

1. 问题描述：
   获取Push token时，调用const pushToken: string = await pushService.getToken();报如下错误：
   1000900010 APP身份验证失败，已配置client_id。请问如何解决？

解决方案：
可能原因：未在AGC平台配置证书指纹，可以看一下文档的证书指纹的生成和配置章节。
请从以下几点排查：

1. 在AGC API管理中，打开相关服务的API。一般存在十分钟左右的延迟。
2. module.json5文件中metadata节点下clientid书写正确。需要在里面直接写client_id的信息，不能通过$符引用资源文件中的值，当前无法解析这种引用方式。
3. “签名证书使用”选项中的配置方式为“选择SHA256公钥指纹‘’。
   a. 生成配置指纹：这里
   b. 配置证书指纹：这里
   如果以上三种方式仍无法您的解决问题，请通过以下方式将日志提供给技术支持人员解决：
4. 执行命令：hdc hilog > xxxx.log
5. 复现场景。
6. 停止脚本执行。
7. 在目录下获取日志信息。