从零到一：uni push2.0全链路配置与实战推送指南-编程阁

1. 为什么需要uni push2.0？

消息推送是移动应用最基础也最重要的功能之一。想象一下，你正在开发一个外卖APP，用户下单后需要实时收到订单状态变更通知；或者是一个社交APP，用户需要及时收到好友消息提醒。这些场景都离不开稳定可靠的消息推送服务。

uni push2.0是DCloud推出的新一代推送服务，相比传统方案有几个明显优势：

全链路支持：同时覆盖在线推送（用户APP在前台运行）和离线推送（APP在后台或关闭状态）
厂商通道集成：自动对接华为、小米、OPPO等手机厂商的系统级推送通道，大幅提升送达率
开发成本低：一套代码同时支持iOS和Android平台，省去了原生开发的适配工作
云函数支持：可以直接在uniCloud中编写推送逻辑，无需自建服务器

我在实际项目中使用过多个推送方案，uni push2.0最大的感受就是配置简单、送达率高。特别是在安卓设备上，通过厂商通道的离线推送几乎能做到100%送达，这对电商类应用来说简直是刚需。

2. 前期准备工作

2.1 开通uniCloud服务

首先需要确保你的项目已经开通uniCloud服务。这里推荐使用阿里云版本，稳定性更好。具体操作：

在HBuilderX中右键项目目录
选择"创建uniCloud云开发环境"
选择阿里云作为服务商
等待环境初始化完成

如果项目已经创建过uniCloud环境，可以跳过这一步。我建议新手先在测试项目上练习，熟悉流程后再应用到正式项目。

2.2 生成推送证书

推送证书是保证消息安全送达的关键。iOS和Android的证书生成方式不同：

Android证书生成：

访问DCloud官方文档获取SHA256指纹
在各大应用市场开发者后台配置签名信息
下载各厂商的配置文件

iOS证书生成：

登录Apple开发者账号
创建APNs证书
导出.p12文件
上传到uniPush控制台

这里有个常见坑点：Android证书需要对应应用签名的SHA256值，如果后期修改了签名文件，必须重新配置所有厂商通道。我就曾经因为更换签名导致推送失效，排查了半天才发现问题。

3. uni push2.0详细配置

3.1 控制台基础配置

登录uni-app开发者中心，找到uniPush 2.0配置页面：

如果没有应用，需要先创建新应用
为应用添加平台信息（iOS和Android需要分别配置）
上传前面生成的证书文件
配置应用包名和Bundle ID

特别注意：Android平台需要配置各厂商的离线推送参数。以华为为例：

应用ID：在华为开发者后台创建应用时分配
应用密钥：同上
回调地址：用于接收推送状态回执

配置完成后建议先保存，不要立即启用。等所有参数检查无误后再开启推送服务。

3.2 厂商通道特殊配置

厂商通道是提升安卓推送到达率的关键。各家配置略有不同：

小米通道：

需要申请推送权限
配置默认通知样式
设置消息分类

OPPO通道：

需要单独申请推送权限
有每日推送限额
必须配置通知图标

vivo通道：

需要上传签名文件
配置消息分类
设置测试设备

实测下来，华为和小米的通道稳定性最好，OPPO和vivo偶尔会有延迟。建议在代码中对不同厂商做兼容处理。

4. 编写推送云函数

4.1 创建云函数

在uniCloud/cloudfunctions目录下新建云函数：

右键点击"新建云函数"
勾选uni-cloud-push扩展库
输入函数名称如"uni-push"

基础推送代码示例：

'use strict'; const uniPush = uniCloud.getPushManager({ appId:"__UNI__XXXXXX" // 替换为你的应用ID }) exports.main = async (event, context) => { const data = JSON.parse(event.body) return await uniPush.sendMessage({ "getui_alias": data.alias, // 使用别名推送 "title": data.title, "content": data.content, "force_notification": true, // 强制显示通知 "payload": data.payload // 自定义数据 }) }

这个示例实现了最基本的推送功能。实际项目中你可能需要添加：

错误处理逻辑
推送频率限制
用户标签支持
A/B测试功能

4.2 部署和调用

编写完成后：

右键云函数选择"上传部署"
在uniCloud控制台找到该函数
复制调用URL

调用示例：

uni.request({ url: '你的云函数URL', method: 'POST', data: { alias: 'user123', title: '订单通知', content: '您的订单已发货', payload: { orderId: '123456' } }, success(res) { console.log('推送成功', res) } })

5. 客户端消息处理

5.1 监听推送消息

在App.vue的onLaunch中添加消息监听：

onLaunch() { // #ifdef APP-PLUS const pushMessageCallback = (res) => { const { data } = res if (res.type === "receive") { // 前台收到消息 console.log('收到推送', data) } else { // 点击通知栏 uni.navigateTo({ url: `/pages/order/detail?id=${data.payload.orderId}` }) } } uni.onPushMessage(pushMessageCallback) // #endif }

5.2 安卓通知渠道配置

安卓8.0以上需要配置通知渠道：

// #ifdef APP-ANDROID const plugin = uni.requireNativePlugin("DCloud-PushSound") if (plugin) { plugin.setCustomPushChannel({ channelId: "order_channel", channelDesc: "订单通知", importance: 3 // 重要程度 }) } // #endif

不同重要程度会影响通知的显示方式：