应用平台

PushEngage for Expo

通过 PushEngage React Native SDK 和 Expo 开发版本在 Expo 应用中使用 PushEngage。不支持 Expo Go,因为它无法运行 SDK 的原生代码。

使用 Expo 可以做什么

与原生 React Native 相同的 API

一旦开发版本就位,JavaScript API 与原生 React Native 项目完全相同。

开发版本中的完整推送功能集

指南列出了支持的深度链接、细分和属性、目标跟踪以及触发式广告系列,并且在添加通知服务扩展后还支持富通知。

Expo 工具链可继续运行

预构建后,您仍然可以使用 EAS Build 和 EAS Update 进行无线更新。

为重新生成的项目提供的示例配置插件

如果您的原生文件夹在每次构建时都会重新生成,指南中包含一个本地 Expo 配置插件,您可以复制它来重新应用应用组密钥和 Android 通知权限。

来自 expo-notifications 的路径

指南将引导您替换 Expo 内置的推送服务:交换权限请求和点击处理程序,并通过 PushEngage REST API 发送。

如何设置

  1. 安装 expo-dev-client 和 @pushengage/pushengage-react-native 包。
  2. 运行 npx expo prebuild –clean 以生成 ios 和 android 文件夹。
  3. 对于 iOS,在 Xcode 中打开生成的项目,添加推送通知、后台模式(带远程通知)和应用组,然后将 PushEngage_App_Group_Key 添加到 Info.plist。
  4. 对于 Android,添加 JitPack 存储库和 Google Services 插件,将 google-services.json 放在 android/app 中,并将 POST_NOTIFICATIONS 权限添加到清单中。
  5. 使用 npx expo run:ios 或 npx expo run:android,或使用 EAS Build 开发配置文件构建开发客户端。
  6. 在应用注册之前,在 index.js 中使用您的应用 ID 初始化 SDK,然后在您的应用中请求通知权限。
  7. 使用 EAS Build 创建您的生产版本。

完整指南:使用 Expo 和原生工作流的 PushEngage

好消息

  • 应用推送和 React Native SDK 在所有 PushEngage 套餐中都有提供,包括免费套餐。目标跟踪、自定义触发式广告系列和应用内消息需要付费套餐。
  • 指南列出了 Expo SDK 49 或更高版本、EAS CLI、用于 iOS 的 Apple Developer 帐户以及用于 Android 的 Firebase 项目作为先决条件。
  • Expo Go 无法运行 PushEngage。请在实体设备上使用开发版本进行测试,因为模拟器无法接收推送通知。
  • Prebuild 会从头开始重新生成原生文件夹。提交 ios 和 android 文件夹,或使用配置插件,以免丢失您的 PushEngage 设置。
  • 推送通知和后台模式功能需要权限,因此仅配置插件无法设置它们。指南建议在 Xcode 中一次性配置它们。
  • PushEngage 不发布自己的 Expo 配置插件。指南中的插件是供您复制到项目中的示例。

关于此连接

  • Expo 支持通过 PushEngage React Native SDK 实现,该 SDK 由 PushEngage 构建和维护。这并非与 Expo 的合作关系。
  • 没有单独的 Expo 包。您需要从 npm 安装 @pushengage/pushengage-react-native。
  • PushEngage 的 API 文档列出了支持 Expo 开发版本(需要手动配置原生模块)、推荐的裸 React Native 设置,以及不支持的 Expo Go。
  • SDK 源代码在 GitHub 的 awesomemotive/pushengage-react-native 仓库中公开,采用 MIT 许可证。

PushEngage 合作伙伴目录

准备好为您的 Expo 应用添加推送功能了吗?从设置指南开始。

PushEngage 有免费套餐,因此您可以在付费之前安装它并发送您的第一个活动。