集成了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
   

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推送证书是否配置正确 （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事件。