前端基于uniapp[uniPush]实现APP消息推送（安卓、IOS）

前提概述：此文章都是基于uniapp中uniPush2实现的在线、离线推送

app消息推送流程

1. 登录开发者中心先填写好项目信息以及配置厂商
2. 在manifest.json文件中勾选推送模块
3. 打包自定义基座
4. 在前端项目中创建云函数（此云函数的作用是接受后台发送的消息模板，解析出来后，发送给到uniapp后台，以此触发消息推送功能）
5. 在app.vue文件中需要做三件事：
   ①获取客户端推送标识
   ②处理离线（推送点击）
   ③在线（接收消息、推送点击）
6. 真机测试

好了，以下会根据上面的五个流程给出的具体笔记。。。

坑点

在具体讲述之前，我觉得可以把坑点先记下来，方便大家避雷：

• 上传iOS证书提示“证书环境错误”的问题

需要上传的是推送证书，不是打包证书

• 配置完成后，运行到真机会出现"打包时未添加push模块,请参考…“的情况

在manifest.json勾选了push模块之后，需要重新打包自定义基座

• 账号共同的问题

你在哪个开发者账号中配置的app,对应的你的HBuilder也要登录那个账号进行开发

• 小米真机测试，出现收不到消息的情况

需要配置推送时间

• 华为离线时，收不到消息推送，若厂商信息确认配置无误，那么检测以下两个地方

1、查看开发者中心 - uniPush - 应用信息，点击 [包名再“应用详情“中”各平台信息“管理，点击前往]，然后选择你的应用进行修改，一定要认真核对 Android 应用签名SHA256 是否填写正确
2、华为推送信息乱写的时候，是可能不被推送的，可以按照以下格式发送排查下：
title：订单提醒
body：您的外卖订单已接单，请耐心等候

• 官方排错文档

如果以上都不能帮助到你，那么再查看这两个文档进行排查：厂商限额和提醒方式说明、uni-push2.0 常见问题，如果都不行的话，只能添加unipush的客服咨询啦

具体处理笔记（从0到1）

1、在开发者中心填写项目信息以及配置厂商（见图）

2、在manifest.json文件中勾选推送模块

上传图片注意事项和格式，看文档

3、更新自定义基座

在 发行->原生APP-云打包，点击打自定义调试基座。这一步，务必保证你前面的配置都好了，尤其是oppo的。

4、在前端项目中创建云函数

消息推送属于敏感操作，只能直接或间接由服务端触发。传统的三方push服务，需要开发者在服务端配置密钥或证书，根据服务器端文档签名获取token，再向相关URL接口发起网络请求…而unipush仅是需要我们创建一个云函数作为一个中转站

• 点击项目，右键点击创建uniCloud云开发环境，然后选择阿里云或者腾讯云
• 创建完成后，右键点击uniCloud选择关联空间
• 再右键点击cloudfunctions,选择新建云函数，新建时可选择uni-cloud-push扩展库

具体里面的内容，我们处理的不需要很多，可以具体看文档，文档写的比较详细，一直往下滑，直接看第四步

5、在app.vue处理消息

注意：安卓和IOS在线推送的情况是，是不会弹出提示的，需要我们手动创建

直接贴代码啦，具体看注释

// #ifdef APP-PLUS // 客户端获取push客户端标记 uni.getPushClientId({ success: async (res) => { let push_clientid = res.cid //这个id是不会改变的，我们需要在登录必经过的页面或者方法拿到这个id传给后端存储起来 uni.setStorageSync('unipush_id', push_clientid) }, fail(err) { console.log('推送id获取失败:', err) }, }) //离线推送-点击信息 plus.push.addEventListener( 'click', async function (msg) { setTimeout(function () { uni.navigateTo({ url: `/${msg.payload['path']}`, }) }, 1000) plus.push.clear() }, false ) // 在线推送-接收信息 plus.push.addEventListener( 'receive', function (msg) { //ios平台需要多一层判断，且拿取方式不同 var platform = uni.getSystemInfoSync().platform if (platform == 'ios') { if (msg.type == 'receive') { // 这里判断触发的来源，否则一直推送。 let options = { cover: false, title: msg.payload.title } plus.push.createMessage(msg.content, msg.payload.path, options) } } else if (platform == 'android') { let option = { cover: false, title: msg.title } plus.push.createMessage(msg.content, msg.payload.path, option) } }, false ) // 在线推送-点击信息 uni.onPushMessage(async (res) => { let data = res.data.payload if (res.type === 'click') { setTimeout(function () { uni.navigateTo({ url: `/${data}`, }) }, 1000) plus.push.clear() plus.runtime.setBadgeNumber(0) //清除图标右上角数字 } }) // #endif

• 1
• 2
• 3
• 4
• 5
• 6
• 7
• 8
• 9
• 10
• 11
• 12
• 13
• 14
• 15
• 16
• 17
• 18
• 19
• 20
• 21
• 22
• 23
• 24
• 25
• 26
• 27
• 28
• 29
• 30
• 31
• 32
• 33
• 34
• 35
• 36
• 37
• 38
• 39
• 40
• 41
• 42
• 43
• 44
• 45
• 46
• 47
• 48
• 49
• 50
• 51
• 52
• 53
• 54
• 55
• 56
• 57
• 58
• 59
• 60

6、真机测试

有两种测试方法：

1. 后端在apipost中弄一个接口，点击发送
2. 在开发者平台->unipush->消息推广->创建推送->透传消息
   注意：
   1、测试小米手机一定要填写定时推送
   2、Android配置里面，initende的填写方式是（以下全部复制哦，然后再根据提示修改）：

intent:#Intent;action=android.intent.action.oppopush;launchFlags=0x14000000;component=安卓包名/io.dcloud.PandoraEntry;S.UP-OL-SU=true;S.title=测试标题;S.content=测试内容;S.payload=test;end

帮到你的话，就点个赞再走吧~