React Native SDK 快速入门

使用这个快速简单的示例开始使用 Pushwoosh React Native SDK

先决条件

要将 Pushwoosh React Native 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-react-native-plugin.git

# 导航到示例目录
cd pushwoosh-react-native-plugin/example/demoapp/

配置项目

安装依赖项：

npm install

打开 Settings.js 并更新 Pushwoosh.init 调用：

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

将 __YOUR_APP_ID__ 和 __YOUR_FCM_SENDER_ID__ 的值替换为您的 Pushwoosh App Code 和 Firebase Project Number。

iOS

1. 安装依赖项

导航到 ios 目录并安装依赖项：

cd ios && pod install --repo-update

2. 设置 Bundle Identifier

在 Xcode 中打开 ios/Runner.xcworkspace 文件。

为每个 target 设置 Bundle Identifier：

• Runner：您的应用的包名。（例如 com.example.pushwoosh）
• NotificationService：您的应用的包名加上 .NotificationServiceExtension。（例如 com.example.pushwoosh.NotificationServiceExtension）

3. 设置 API Token

在您的 ios/Runner/Info.plist 中，将 Pushwoosh_API_TOKEN 键设置为 Pushwoosh Device API Token

Android

1. 设置 google-services.json

将您的 google-services.json 文件复制到 android/app 目录

2. 设置包名

打开 android/app/build.gradle 并将 applicationId 设置为您的应用的包名。（例如 com.example.pushwoosh）

3. 设置 API Token

打开您的 android/app/src/main/AndroidManifest.xml 文件，并在 <application> 标签内添加以下元数据：

AndroidManifest.xml

<meta-data android:name="com.pushwoosh.apitoken" android:value="__YOUR_PUSHWOOSH_DEVICE_API_TOKEN__" />

将 __YOUR_PUSHWOOSH_DEVICE_API_TOKEN__ 替换为您的 Pushwoosh Device API Token。

运行项目

1. 构建并运行项目。
2. 应用将有两个标签：“Actions” 和 “Settings”。导航到 Settings 标签。
3. 点击 Register for Push Notifications 按钮。
4. 授予推送通知权限。设备将在 Pushwoosh 注册。

发送推送通知

返回 Pushwoosh Control Panel 并向您注册的设备发送推送通知。