集成了GoEasy原生插件实现Uniapp通知栏推送收不到通知,如何排查?

无论您是使用IM即时通讯 还是websocket消息推送需要通知栏推送,收不到通知栏推送都可以通过以下方式来排查。

本地通知跟离线通知的区别

通知栏推送分两种(理解了这个,对接下来如何排查很重要):

  1. 本地通知
  2. 离线通知

本地通知,指app在后台运行,且goeasy websocket连接未断开时,处理的通知栏推送,此时通知栏推送是goeasy sdk完成的,无上架要求。

离线通知, 指goeasy连接断开或者app进程被杀后,需要通过厂商推送来实现的通知栏提醒。什么意思呢? 就是这种情况下,只有通过各个手机厂商自己的推送服务平台向手机推送通知栏推送。目前goeasy支持以下厂商:

  1. APNs (iOS苹果)
  2. 小米 (需要上架才能推送)
  3. 华为
  4. vivo (需要上架才能推送)
  5. oppo
  6. 魅族
  7. FCM (这个只适用海外用户通过google服务来进行通知栏推送,国内的项目用不上,因为google服务被墙了)

如何排查收不到本地通知

  1. 初始化时allowNotification值是否为true
    集成了GoEasy原生插件实现Uniapp通知栏推送收不到通知,如何排查?_第1张图片

  2. 发送消息时是否有带notification的相关参数
    集成了GoEasy原生插件实现Uniapp通知栏推送收不到通知,如何排查?_第2张图片

  3. 在手机系统设置里确认,该app的通知栏提醒为“允许”状态

  4. GoEasy的sdk版本是否低于2.2.8,如果是,请在官网下载最新的sdk进行集成

  5. 检查manifest.json中权限配置是否勾选NOTIFICATION相关权限,并检查manifest.json的源码视图中是否有同步更新
    集成了GoEasy原生插件实现Uniapp通知栏推送收不到通知,如何排查?_第3张图片

  6. 检查manifest.json中模块配置是否勾选上了push模块, 且一定不能勾选unipush,检查manifest.json的源码视图中distribute节点中配置中是否包含pushRegisterMode参数配置?pushRegisterMode是unipush的配置,个别hbuilder版本下,模块配置中没有勾选unipush但是源码视图中有。如果有,需要删除这个参数。

  7. GoEasy连接是否已经断开, 如果已经断开,则需要集成厂商通道才能推送通知栏提醒
    (注意大多数vivo手机一切换到后台运行后,app的某些资源几乎会马上回收导致goeasy连接断开,所以需要结合goeasy后台的在线客户端页面来确认连接是否还在)

  8. 如果是付费应用,排查是否购买了通知栏推送服务

如何排查收不到离线通知

APNs (iOS苹果离线推送)不工作

  1. app在后台运行是否可以收到通知栏提醒,如果收不到说明代码或者环境有问题,需要先解决这个问题再往下看
  2. 是否添加了原生插件并按文档要求打包自定义基座(特别是是须勾选了push模块且不能勾选unipush)
  3. 确认iOS推送证书是否配置正确 (90%的用户都是这一块有问题,重点排查)
    a. 请确认是否在GoEasy后台上传时的iOS的推送证书【跟制作基座时用的证书是完全不同的证书,打包时用的是开发证书,厂商推送是推送证书】
    b. ios推送证书与开发证书的bundle id是否一致
    c. 推送证书是否是测试环境跟正式环境通用的证书
    d. 如果您选择的运行证书的环境为正式环境,您的app是否已经上架app store
    e. 如果app已经上架,需要选择正式环境,如果选择了测试环境,则收不到
  4. 确认iOS开发证书是否包含push notification权限,如果没有需要重新生成开发证书
  5. 如果还是不工作,强烈建议,按照文档重新生成一次推送证书!!

小米离线推送不工作

  1. app在后台运行是否可以收到通知栏提醒,如果收不到说明代码或者环境有问题,需要先解决这个问题再往下看

  2. 是否添加了原生插件并按文档要求打包自定义基座(特别是是须勾选了push模块且不能勾选unipush)

  3. 小米开放平台填写的应用包名是否与制作自定义基座时填写的Android包名完全一致

  4. 小米推送服务没有通过申请。app需要在小米应用市场上架,并在小米开发平台申请推送服务,只有申请通过后才能使用小米离线推送。

  5. 在GoEasy网后台配置uniapp通知栏推送小米参数时提示无效,导致没有成功配置小米厂商
    解决方案:小米如果是刚开启的推送权限,需要等待几分钟后才会生效。您可以等3分钟以后再去配置

  6. 打自定义基座时报错“arguments invalid”,在原生插件配置页面,没有正确配置厂商相关参数
    解决方案:检查配置值的前后是否有多余的空格; 其次检查值是否正确,比如appkey 跟appsecret的值要正确,不要填错了

  7. 受到小米厂商推送限制影响。如果至少收到过一次离线推送,说明厂商配置没有问题,可能受到小米厂商限制,需要申请小米厂商分类消息。 参考文档:https://docs.goeasy.io/2.x/common/notification/channel_category

华为离线推送不工作

  1. app在后台运行是否可以收到通知栏提醒,如果收不到说明代码或者环境有问题,需要先解决这个问题再往下看

  2. 是否添加了原生插件并按文档要求打包自定义基座(特别是是须勾选了push模块且不能勾选unipush)

  3. 华为开发者平台填写的应用包名是否与制作自定义基座时填写的Android包名完全一致

  4. 华为开发者平台中的推送服务是否成功的开启

  5. 是否正确的生成了SHA256证书指纹

  6. 打自定义基座时报错“arguments invalid”,在原生插件配置页面,没有正确配置厂商相关参数
    解决方案:检查配置值的前后是否有多余的空格; 其次检查值是否正确

  7. goeasy后台厂商通道配置参数要正确

  8. 受到华为厂商推送限制的影响。如果至少收到过一次离线推送,说明厂商配置没有问题,可能受到华为厂商限制,需要申请华为厂商分类消息。 参考文档:https://docs.goeasy.io/2.x/common/notification/channel_category

vivo离线推送不工作

  1. app在后台运行是否可以收到通知栏提醒,如果收不到说明代码或者环境有问题,需要先解决这个问题再往下看 (注意大多数vivo手机一切换到后台运行后,app的某些资源几乎会马上回收导致goeasy连接断开,所以需要结合goeasy后台的在线客户端页面来确认连接是否还在)

  2. 是否添加了原生插件并按文档要求打包自定义基座(特别是是须勾选了push模块且不能勾选unipush)

  3. vivo开发者平台填写的应用包名是否与制作自定义基座时填写的Android包名完全一致

  4. vivo开发者平台中的推送服务是否已经通过申请

  5. app是否在vivo应用市场已上架

  6. 打自定义基座时报错“arguments invalid”,在原生插件配置页面,没有正确配置厂商相关参数
    解决方案:检查配置值的前后是否有多余的空格; 其次检查值是否正确

  7. goeasy后台厂商通道配置参数要正确

  8. 受到vivo厂商推送限制的影响。如果至少收到过一次离线推送,说明厂商配置没有问题,可能受到vivo厂商限制,需要发送时需要根据业务真实指定classification参数, 0:运营类消息,1:系统类消息,不填默认为1。 参考文档:https://docs.goeasy.io/2.x/common/notification/channel_category

oppo离线推送不工作

  1. app在后台运行是否可以收到通知栏提醒,如果收不到说明代码或者环境有问题,需要先解决这个问题再往下看

  2. 是否添加了原生插件并按文档要求打包自定义基座(特别是是须勾选了push模块且不能勾选unipush)

  3. oppo开发者平台填写的应用包名是否与制作自定义基座时填写的Android包名完全一致

  4. oppo开发者平台中的推送服务是否已经通过申请

  5. 打自定义基座时报错“arguments invalid”,在原生插件配置页面,没有正确配置厂商相关参数
    解决方案:检查配置值的前后是否有多余的空格; 其次检查值是否正确,appkey,appsecret, appserversecret 的值要正确的填写

  6. goeasy后台厂商通道配置参数要正确

  7. 受到oppo厂商推送限制的影响。如果至少收到过一次离线推送,说明厂商配置没有问题,可能受到oppo厂商限制,需要申请oppo厂商分类消息。 参考文档:https://docs.goeasy.io/2.x/common/notification/channel_category

魅族离线推送不工作

  1. app在后台运行是否可以收到通知栏提醒,如果收不到说明代码或者环境有问题,需要先解决这个问题再往下看

  2. 是否添加了原生插件并按文档要求打包自定义基座(特别是是须勾选了push模块且不能勾选unipush)

  3. 魅族开发者平台填写的应用包名是否与制作自定义基座时填写的Android包名完全一致

  4. 魅族开发者平台中的推送服务是否已经开启

  5. 打自定义基座时报错“arguments invalid”,在原生插件配置页面,没有正确配置厂商相关参数
    解决方案:检查配置值的前后是否有多余的空格; 其次检查值是否正确,appkey,appsecret 的值要正确的填写

  6. goeasy后台厂商通道配置参数要正确

FCM 没有使用到,所以没有相关问题排查。

如果以上排除步骤无法锁定原因,按照GoEasy厂商通道配置文档再走两遍,不要自认为没有问题,厂商通道的配置没有什么难点,主要是要细心。
如果实在无法排查到原因,就上GoEasy官网找客服吧,他们会很耐心地帮您排查问题。

通知栏消息提醒方式

问题1: 为啥我的通知栏消息没有悬浮弹窗提醒?
答:通知栏消息被静默显示,一方面取决于厂商对不同类型通知有不同的展示规则,另一个方面也要取决于app在手机上的设置,看是否打开了悬浮通知。

问题2: 为啥小米手机上不是每条消息都会通知?比如发送3条,只有第一条会有提示,后面两条都没有提示?
答:这个取决于手机操作系统的规则,为了在避免打扰到用户,部分手机厂商会对通知频繁的app进行提示限制,比如只会折叠通知不会响铃,有些手机厂商只有当用户点击了通知之后才会重新提醒(带提示音)。

监听通知栏点击事件

户点击通知栏消息,除了APP被自动拉起外,开发者还可以通过监听通知栏消息的点击事件,根据消息数据,执行相应的业务逻辑,比如跳转到不同的页面,或显示不同的内容。

为了避免在APP启动后,因为监听动作未完成而导致APP无法响应点击操作,确保APP总是可以第一时间响应通知栏消息的点击事件,请务必在main.js GoEasy初始化后,立即监听onClickNotification事件

集成了GoEasy原生插件实现Uniapp通知栏推送收不到通知,如何排查?_第4张图片

你可能感兴趣的:(uniapp通知栏推送,uni-app)