uniapp实战：从零到一实现uni-push消息推送功能

1. 为什么你的App需要消息推送？从“通知”到“连接”的转变

消息推送，听起来是个技术名词，但说白了，就是让你的App能主动给用户“发消息”。想想看，你手机里那些App，是不是经常弹出一个提醒：“您有一笔新订单”、“好友给您发了一条消息”、“限时优惠即将结束”？这些就是消息推送的功劳。没有它，你的App就像一个单向的收音机，只能等用户打开才能“播放”内容；而有了它，App就变成了一个能主动“喊话”的智能助手，随时能把重要信息送到用户眼前，极大地提升了用户活跃度和留存率。

在uni-app生态里，uni-push就是官方提供的这套“喊话系统”。它最大的好处就是一套代码，全端通用。无论是iOS、Android，还是各家小程序、快应用，你只需要对接uni-push这一个通道，就不用再分别去折腾苹果的APNs、小米推送、华为推送等等，省去了大量繁琐的配置和兼容工作。这对于我们中小团队或者独立开发者来说，简直是福音，能把精力更集中在业务逻辑本身。

我刚开始做App的时候，也觉得推送功能很复杂，涉及到各种证书、厂商配置，头都大了。但实际用上uni-push之后发现，它的设计思路非常“uni-app”，就是尽可能把复杂的东西封装起来，给开发者一个简单统一的接口。我们只需要关心两件事：什么时候推和推什么内容。至于消息是怎么跨过千山万水、穿过不同手机系统送到用户设备上的，DCloud的团队已经帮我们搞定了。

所以，无论你是要做电商的订单提醒、社交的即时通讯、内容资讯的更新通知，还是工具类的定时提醒，uni-push都是一个绕不开的核心功能。接下来，我就带你从零开始，手把手把它集成到你的uni-app项目里，我会把每一步的细节和我踩过的坑都讲清楚，保证你跟着做就能成功。

2. 前期准备：开通服务与基础配置

万事开头难，但uni-push的开头还算简单。整个过程就像开通一个云服务，你需要先去服务商那里注册个账号，拿到钥匙，然后告诉你的项目怎么用这把钥匙。

2.1 在DCloud开发者中心开通uni-push

首先，你需要一个DCloud开发者账号。如果你还没有，去DCloud开发者中心注册一个。登录之后，找到“uni-push”服务，点击开通。这个过程基本上是免费的，对于个人开发者和初期项目来说，赠送的额度完全够用。

开通成功后，你会进入uni-push的管理后台。这里最重要的一步是创建应用。点击“创建应用”，填写你的应用名称和包名（Bundle Identifier / Package Name）。这里的包名一定要和你最终打包App时使用的包名完全一致，一个字母都不能错，否则后续推送绝对收不到。我建议你直接在HBuilderX的“manifest.json”文件里，先配置好App的基础设置，把包名复制过来用，避免手误。

创建应用后，系统会为这个应用生成一个唯一的 AppID。这个AppID是后续所有配置和代码中识别你应用的“身份证号”，务必记下来。同时，管理后台也会展示一些配置信息，比如各厂商通道的配置入口（这个我们稍后讲离线推送时会用到），现在可以先不用管。

2.2 在项目中配置Push模块

钥匙拿到了，现在要把它装到你的项目门上。这个“装”的过程，就是在项目的配置文件中声明：我这个App要用推送功能。

用HBuilderX打开你的uni-app项目，找到根目录下的 manifest.json 文件。这是uni-app项目的核心配置文件。点击进入“App模块配置”选项卡，你会看到一个长长的功能列表。在里面找到 “Push(消息推送)”，把它勾选上。

勾选之后，下方通常会出现一些子选项或配置项。确保“uni-push 2.0”被选中（目前这是主流版本）。完成这一步，相当于在你的App“蓝图”上标注了“此处预留推送功能接口”。当你后续使用云打包或本地打包时，打包工具就会把推送所需的原生SDK和权限集成到最终的安装包里。

这里有个小细节：如果你之前打包过App，修改了manifest.json的模块配置后，必须重新打包才能生效。仅仅在真机运行基座上是看不到效果的，因为真机运行基座是一个通用的调试包，并没有包含你项目特有的模块。

3. 在线推送实战：让App“活”起来

配置好之后，我们就要开始写代码了。我们先实现最简单的“在线推送”。所谓“在线”，就是指用户的App正处于前台运行，或者后台存活但网络连接保持畅通的状态。这种场景下的推送最及时，实现也最直接。

3.1 前端监听：准备好接收消息的“耳朵”

推送是双向的，一端是服务端发送，另一端是客户端接收。我们先在客户端把“耳朵”竖起来。这个逻辑通常写在项目的入口文件 App.vue 的 onShow 生命周期里。

// App.vue
export default {
  onShow: function() {
    console.log('App Show')

    // 1. 获取客户端标识CID（可选，但很重要）
    uni.getPushClientId({
      success: (res) => {