uni-app 集成推送

研究了几天，终于是打通了uni-app的推送，本文主要针对的是App端的推送开发过程，分为在线推送和离线推送。我们使用uni-app官方推荐的uni-push2.0。官方文档

准备工作：开通uni-push功能

1. 勾选uniPush2.0
2. 点击"配置"
3. 填写表单

关联服务空间说明：

uni-push2.0需要开发者开通uniCloud。不管您的业务服务器是否使用uniCloud，但实现推送，就要使用uniCloud服务器。

• 如果您的后台业务使用uniCloud开发，那理解比较简单。
• 如果您的后台业务没有使用uniCloud，那么也需要在uni-app项目中创建uniCloud环境。在uniCloud中写推送逻辑，暴露一个接口，再由业务后端调用这个推送接口。

在线推送

以上操作配置好了以后，回到HBuilderX。

因为上面修改了manifest.json配置，一定要重新进行一次云打包(打自定义调试基座和打正式包都可以)后才会生效。

客户端代码

我这边后端使用的是传统服务器，未使用云开发。要实现推送，首先需要拿到一个客户端的唯一标识，使用uni.getPushClientId API链接地址

onLaunch() {
    uni.getPushClientId({
        success: (res) => {
            let push_clientid = res.cid
            console.log('客户端推送标识:', push_clientid)
            // 保存在全局，可以在进入app登录账号后调用一次接口将设备id传给后端
            this.$options.globalData.pushClientId = push_clientid
            // 一进来就掉一次接口把push_clientid传给后端
            this.$setPushClientId(push_clientid).then(res => {
                console.log('[ set pushClientId res ] >', res)
            })
        },
        fail(err) {
            console.log(err)
        }
    })
}

客户端监听推送消息

监听推送消息的代码，需要在收到推送消息之前被执行。所以应当写在应用一启动就会触发的应用生命周期onLaunch中。

//文件路径：项目根目录/App.vue
export default {
    onLaunch: function() {
        console.log('App Launch')
        uni.onPushMessage((res) => {
            console.log("收到推送消息：",res) //监听推送消息
        })
    },
    onShow: function() {
        console.log('App Show')
    },
    onHide: function() {
        console.log('App Hide')
    }
}

服务端代码

1. 鼠标右击项目根目录，依次执行

2. 然后右击uniCloud目录，选择刚开始创建的云服务空间

3. 在cloudfunctions目录右击，新建云函数/云对象，命名为uni-push，会创建一个uni-push目录

4. 右击uni-push目录，点击 管理公共模块或扩展库依赖，选择uni-cloud-push

5. 右击database目录，新建DB Schema，创建这三张表:opendb-tempdata,opendb-device,uni-id-device，也就是json文件，直接输入并选择相应的模板。

• 修改index.js

'use strict';
const uniPush = uniCloud.getPushManager({appId:"__UNI__XXXX"}) //注意这里需要传入你的应用appId
exports.main = async (event, context) => {
  console.log('event ===> ', event)
  console.log('context ===> ', context)
  // 所有要传的参数，都在业务服务器调用此接口时传入
  const data = JSON.parse(event.body || '{}')
  console.log('params ===> ', data)
	return await uniPush.sendMessage(data)
};

• package.json

{
  "name": "uni-push",
  "dependencies": {},
  "main": "index.js",
  "extensions": {
    "uni-cloud-push": {}
  }
}

6. 右击uni-push目录，点击上传部署

7. 云函数url化

   登录云函数控制台，进入云函数详情

8. postman测试一下接口

没问题的话，客户端将会打印“console.log(“收到推送消息：”, xxx)”，这一步最好是使用真机，运行到App基座，使用自定义调试基座运行，会在HBuilderX控制台打印。

离线推送

APP离线时，客户端收到通知会自动在通知栏创建消息，实现离线推送需要配置厂商参数。

苹果需要专用的推送证书，创建证书参考链接

安卓需要在各厂商开发者后台获取参数，参考链接

参数配置好了以后，再次在postman测试

注意
安卓需要退出app后，在任务管理器彻底清除进程，才会走离线推送

解决离线推送没有声音

这个是因为各安卓厂商为了避免开发者滥用推送进行的限制，因此需要设置离线推送渠道，查看文档

调接口时需要传一个channel参数

实现离线推送自定义铃声

这个功能只有华为和小米支持

也需要设置channel参数，并使用原生插件，插件地址

注意
使用了原生插件，一定要重新进行一次云打包

• 华为，申请了自分类权益即可
• 小米，在申请渠道时，选择系统铃声，url为android.resource://安卓包名/raw/铃声文件名(不要带后缀)