更新记录

1.0.6（2026-06-01） 下载此版本

增加错误提示

1.0.5（2026-06-01） 下载此版本

配置基础参数增加到达率

1.0.4（2026-06-01） 下载此版本

优化

平台兼容性

uni-app(5.11)

app-push-utils (云端一体化消息推送插件)

app-push-utils 是一个 uni_modules 云端一体化特性的全栈消息推送方案。 前端 SDK（负责 CID 生成、离线通知拦截、应用内跳转分发）与 后端（uni-push2.0）三合一，做到一次导入，多端开箱即用。

🚀 快速接入

1. 前端业务配置与拦截

本插件基于 TypeScript。建议在项目主入口或 @/utils/index.ts 中对其进行重导出并完成配置。

// @/utils/index.ts
import { UniPush, PushActionType } from "@/uni_modules/app-push-utils/js_sdk";

// 单例获取推送实例
const pushService = UniPush.getInstance();

export { pushService, PushActionType };

在系统登录成功后或 App 启动阶段：

import { pushService } from "@/utils";

pushService.getCid().then((cid) => {
  console.log("当前设备的推送标识 CID:", cid);
  // 可将 cid 绑定到您的业务用户系统
});

2. 后端云端下发

后端直接调用云函数，按照官方 uni-push2.0 标准传入参数调用即可。

3. 前端创建本地消息

pushService.createLocalMessage({
  title: "消息通知",
  content: "您有一条未读消息，请点击查看",
  payload: {
    action: PushActionType.NAVIGATE,
    path: `/pages/notice/index?type=all`,
  },
});