PushEngage for React Native
使用 PushEngage React Native SDK,为 Android 和 iOS 上的 React Native 应用添加推送通知和应用内消息。一个支持 TypeScript 和 JavaScript 的 npm 包涵盖了两个平台,并且可以在 PushEngage 控制面板中运行广告系列。
使用 React Native 可以做什么
一个包支持 Android 和 iOS
一个 JavaScript API 位于原生 Swift 和 Kotlin 代码之上,通过 Android 上的 Firebase Cloud Messaging 和 iOS 上的 Apple Push Notification service 进行推送。
深度链接和冷启动点击
当用户点击通知时,监听器会接收深度链接和通知数据,并且有一个单独的调用会返回启动应用的通知。
权限和订阅一步完成
请求通知权限并在用户允许时同时订阅用户,因此无需单独的订阅步骤。
细分、属性和触发式广告系列
从 JavaScript 添加订阅者到静态或动态细分,设置自定义属性,并发送触发事件、目标和价格下降或库存警报。
应用内消息
显示在控制面板中设计的横幅、模态框和全屏消息。一旦 SDK 拥有您的应用 ID,就不需要进行 JavaScript 端设置。
原生工作流和 Expo 开发构建
完全支持原生 React Native 项目。Expo 项目通过开发构建运行,该构建在本目录的 Expo 页面中有介绍。
如何设置
- 使用 npm 或 yarn 安装 @pushengage/pushengage-react-native。
- 对于 Android,请设置 Firebase Cloud Messaging,并在 PushEngage 的“站点设置 > 安装 > Android SDK”下输入您的发送者 ID 和服务帐户 JSON。
- 对于 iOS,请在 Xcode 中添加推送通知和后台模式,并在 PushEngage 的 iOS SDK 选项卡下上传您的 APNs 证书。
- 为 iOS 项目添加通知服务扩展。通知内容扩展是可选的。
- 将应用组功能添加到主应用目标和扩展。
- 在应用注册之前,在根目录的 index.js 中使用您的应用 ID 初始化 SDK,并为 iOS 添加 AppDelegate.mm 中的 PushEngage 行。
- 在实体设备上运行,并从“广告系列 > 推送广播”发送测试。
完整指南:React Native 快速入门指南
好消息
- 应用推送和此 SDK 包含在所有 PushEngage 计划中,包括免费计划。目标跟踪、自定义触发式广告系列和应用内消息需要付费计划。
- 当前 SDK 需要 React Native 0.78 或更高版本以及新架构(Turbo Modules)。文档将较旧的 React Native 版本指向更早的 SDK 版本。
- Android 需要 Firebase 项目,iOS 需要具有应用 ID 和 APNs 证书的 Apple Developer 帐户。
- 该SDK包含原生代码,因此无法在Expo Go中运行。请使用裸项目或Expo开发构建。
- 双方仍需要进行原生设置:Android需要Gradle和Firebase,iOS需要Xcode功能和通知服务扩展。
- 如果iOS构建在禁用C++模块的情况下因@import而失败,请在Xcode的“其他C++标志”中添加-fcxx-modules。
关于此连接
- PushEngage构建并维护此SDK。它并非与Meta或React Native项目合作。
- 源代码在GitHub的awesomemotive/pushengage-react-native存储库中公开,采用MIT许可证。
- 该软件包在npm的@pushengage范围内发布。
- PushEngage还发布开源的Agent Skills,因此像Claude Code或Cursor这样的AI编码代理可以运行集成并诊断中断的设置。
PushEngage 合作伙伴目录
准备好为您的React Native应用添加推送功能了吗?从设置指南开始。
PushEngage 有免费套餐,因此您可以在付费之前安装它并发送您的第一个活动。