Expo SDK 快速入门

通过这个快速简单的示例开始使用 Pushwoosh Expo SDK。

前提条件

要将 Pushwoosh Expo SDK 集成到您的应用中，您需要具备以下条件：

要求

• 一个 Pushwoosh 账户。
• 一个在您的账户中设置好的 Pushwoosh 项目。
• 对于 iOS 集成：
  • 一个配置为发送推送通知的 iOS 平台。我们建议使用 基于令牌的身份验证配置 作为最简单的方法。
  • 在设置过程中，将 Gateway 设置为 Sandbox，以便向模拟器发送推送。
• 对于 Android 集成：
  • 一个 已配置的 Android 平台
  • 来自您的 Firebase 项目的 project number (也称为 Sender ID)、google-services.json 文件和 package name。
  • 一个连接到您的 Android 应用程序的 Firebase 项目。如果需要，请遵循 Firebase 设置指南。
• 来自您应用程序的 Pushwoosh 控制面板的 Pushwoosh Application Code 和 Pushwoosh Device API Token。

下载示例项目

# 克隆 SDK 仓库并导航至示例项目
git clone https://github.com/Pushwoosh/pushwoosh-expo-plugin-sample.git

# 导航至示例目录
cd pushwoosh-expo-plugin-sample/

配置项目

1. 安装依赖项：

npm install

2. 初始化 Pushwoosh：

打开 app/_layout.tsx 并更新 Pushwoosh.init 调用：

Pushwoosh.init({ pw_appid: "__YOUR_APP_CODE__", project_number: "__YOUR_FCM_SENDER_ID__" });

其中：

__YOUR_APP_CODE__ 是来自 Pushwoosh 控制面板的应用程序代码。 __YOUR_FCM_SENDER_ID__ 是来自 Firebase 控制台的 Firebase 项目编号。

3. 设置包名和 bundle ID：

打开 app.json 并设置：

• package 为您应用的包名。
• bundleIdentifier 为您应用的 bundle ID。

4. 设置 Pushwoosh Device API token：

打开您的 app.json 文件，并为两个平台设置 Pushwoosh Device API Token：

• PW_API_TOKEN iOS 平台的 device API token 值。
• apiToken Android 平台的 device API token 值。

5. 添加 Firebase 配置文件：

将您的 google-services.json 文件复制到项目的根目录。

预构建应用

通过运行 prebuild 为每个平台生成原生代码并配置依赖项：

npx expo prebuild

构建并运行项目

1. 构建项目：

Android

npx expo run:android

iOS

npx expo run:ios

2. 授予推送通知权限。设备将在 Pushwoosh 注册，并启用推送通知。

发送推送通知

返回 Pushwoosh 控制面板，并向您注册的设备发送推送通知。