React Native SDK 快速入门

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

前提条件

要将 Pushwoosh React Native SDK 集成到您的应用中，您需要以下内容：

Requirements

• A Pushwoosh account.
• A Pushwoosh project set up in your account.
• For iOS integration:
  • An iOS platform configured to send push notifications. We recommend using the Token-Based Authentication configuration as the simplest approach.
  • During setup, set the Gateway to Sandbox to send pushes to a simulator.
• For Android integration:
  • A configured Android platform
  • The project number(also known as Sender ID) , google-services.json file and package name from your Firebase project.
  • A Firebase project connected to your Android application. Follow the Firebase setup guide if needed.
• Your Pushwoosh Application Code and Pushwoosh Device API Token from the Pushwoosh Control Panel for your application.

下载示例项目

# 克隆 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 应用代码 和 Firebase 项目编号。

iOS

1. 安装依赖项

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

cd ios && pod install --repo-update

2. 设置 Bundle Identifier

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

为每个目标设置 Bundle Identifier：

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

3. 设置 API Token

在您的 ios/Runner/Info.plist 中，将 Pushwoosh_API_TOKEN 键设置为 Pushwoosh 设备 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 设备 API Token。

运行项目

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

发送推送通知

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