Cordova SDK 快速入门

使用这个快速简单的示例来开始使用 Pushwoosh Cordova SDK

前提条件

要将 Pushwoosh Cordova 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。

下载示例项目

# Clone the SDK repository and navigate to the example project
git clone https://github.com/Pushwoosh/pushwoosh-phonegap-plugin.git

# Navigate to example directory
cd pushwoosh-phonegap-plugin/example/newdemo/

配置项目

安装依赖项：

npm i

添加 Pushwoosh 插件：

cordova plugin add ../../ --link --nofetch

打开 www/js/index.js 文件并更新 pushwoosh.onDeviceReady 调用：

pushwoosh.onDeviceReady({
    appid: "XXXXX-XXXXX",
    projectid: "XXXXXXXXXXXXXXX"
});

将 appid 和 projectid 的值替换为您的 Pushwoosh App Code 和 Firebase Project Number。

iOS

1. 设置 Bundle Identifier

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

为每个 target 设置 Bundle Identifier：

• newdemo：您的应用的包名。（例如 com.example.pushwoosh）

2. 添加 capabilities

要启用推送通知，您需要添加某些 capabilities。

在 Signing & Capabilities 部分，添加以下 capabilities：

• Push Notifications
• Background Modes。添加此 capability 后，勾选 Remote notifications 复选框。

3. 设置 API Token

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

Android

1. 设置 google-services.json

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

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. 切换 Register for notifications 开关。
3. 授予推送通知权限。设备将在 Pushwoosh 注册。

发送推送通知

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