Uniapp+GoEasy原生插件实现通知栏推送过程中的问题排查记录

我们是uniapp开发的app，项目中的系统消息推送使用的是GoEasy Websocket 实时推送，上线一段时间后，客户反馈说，当app没有在前台运行时也需要想办法通知用户一些重要的系统通知。那么此时通知栏推送就需要集成了。
集成通知栏推送很麻烦，国内一些公司做了一些插件来帮我们打通app跟厂商之间的api的调用，这确实也大大减少了开发者的工作量，但是在集成厂商通道的过程中还是遇到了一些问题， 我这里记录一下，也方便之后为其他app项目集成厂商通道时方便排错。

为什么选择GoEasy原生插件来实现通知栏推送 而不是unipush？

1. 使用GoEasy原生插件来推送通知栏提醒只会在需要推送通知栏的时候推送，不会滥推给客户带来骚扰。
   app前台运行时我们使用的是 GoEasy Websocket， 所以 GoEasy知道客户端的连接情况，根据GoEasy websocket的连接情况来推送该推送的通知栏提醒。 如果用unipush，这个是否在线的判断，就需要我自己来做，而且我也很难判断，又不可能每条都推送通知栏提醒。
2. GoEasy通知推送为付费服务，当通知栏推送不工作时，有专人协助我排查问题，但是使用unipush，虽然免费，但是收不到通知栏推送消息时，几乎只能靠自己 和百度来解决问题，调试成本高。

通知栏推送的分类和基本工作方式

通知栏推送分两种：

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
   

2. 发送消息时是否有带notification的相关参数
   

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

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

5. 检查manifest.json中权限配置是否勾选NOTIFICATION相关权限，并检查manifest.json的源码视图中是否有同步更新
   

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推送证书是否配置正确
   a. 请确认是否在GoEasy后台上传时的iOS的推送证书【跟制作基座时用的证书是完全不同的证书，打包时用的是开发证书，厂商推送是推送证书】
   b. ios推送证书与开发证书的bundle id是否一致
   c. 推送证书是否是测试环境跟正式环境通用的证书
   d. 如果您选择的运行证书的环境为正式环境，您的app是否已经上架app store
   e. 如果app已经上架，需要选择正式环境，如果选择了测试环境，则收不到
4. 确认iOS开发证书是否包含push notification权限，如果没有需要重新生成开发证书

小米离线推送不工作

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事件。