uniPush实战操作详细教程步骤

UniPush使用经历整理

提示：文章写完后，目录可以自动生成，如何生成可参考右边的帮助文档

---

前言

通过uniapp框架做的App希望能实现推送提醒，本想选择个推实现，发现uniapp下有个unipush，想必应该集成起来会更简单，详细介绍可以参考官方文档Unipush1.0

---

一、开通Unipush

1.官方开通Unipush参考文档UniPush开通指南。
2.开通 Uni Push 功能时，需要提交应用相关信息

①APPID：可以在：应用管理→我的应用→Appid 查看，如下图
②应用名称：可以在：应用管理→我的应用→应用名称 查看，如下图

③android包名：可以直接选择到，可以在HBuilderX打包页面可以查看到，如下图，应该是uni.+AppId（不包含AppId中的下划线）

④Android应用签名：申请App证书文件时一般会一起下载下来，如果已经绑定到应用中，在选择Android包名时直接会携带过来，可以在 应用管理→我的应用→各平台信息由选择对应的App点击“修改”即可查看或修改对应的几项信息；

二、使用步骤

1.App模块配置

需要将app的manifest.json的App模块配置中的Push勾选上，如下图：

2.打自定义调试基座

需要进行打自定义调试基座方便调试测试消息的推送，如下图：

然后我们在运行到自定义基座有可能找不到，在新的HBuilderX版本中，需要通过以下方式找到 运行→运行到手机或模拟器→运行到Android App基座，如下图

然后选择 使用自定义基座运行，会自动显示包名等信息

3.获取CID测试

3.1获取CID的代码如下：

//获取cid				
console.log(plus.push.getClientInfo().clientid)
console.log('cid')

3.2然后在uniPush→消息推送→配置管理→故障排查→状态查询下输入CID，点击一键检测，然后自动加载到CID列表中说明检验成功；

3.3然后录入测试消息内容，再点击预览

3.4录入CID，点击“测试”消息就发生成功了，点击“确定”会创建消息到“推送记录”（在uniPush→消息推送→数据统计→推送记录）

3.5对应的手机收到消息，实测效果如下图

总结

实现过程中遇到很多问题：
1.CID不存在或不属于此应用：解决方案上面已经描述，就是需要打自定义调试基座；参考链接解决CID不存在或不属于此应用
2.获取CID：上述已贴上代码，可以写在一运行就进行获取log出来；
3.**使用uniPush1.0还是uniPush2.0？**我对比了一下，uniPush2.0需要uni服务空间，是需要收费的，但是收费非常低，如果客户原因可以考虑使用uniPush2.0，因为此版本按官方说法兼容机型更全面；
4.HBuilderX选择不到运行基座：可能因为HBuilder的版本问题，选择自定义运行基座的菜单在不同的地方，我的是在 运行→运行到手机或模拟器→运行到Android App基座 进行选择的；
5.厂商推送设置：我的是荣耀手机，可以选择华为的设置方式；设置的参数的获取方式可以参考：华为推送设置
6.同步资源失败，未得到同步资源的授权，请停止运行后重新运行，并注意手机上的授权提示：这个在运行的时候要让手机保持不息屏，在运行安装基座时，编译时间较长导致手机都息屏了，然后在安装基座时会询问手机授权，超时不授权就会出现此错误；