# Cordova SDK 基础集成指南
本节包含有关如何将 Pushwoosh Cordova SDK 集成到您的应用程序中的信息。
## 先决条件
要将 Pushwoosh Cordova SDK 集成到您的应用中，您需要以下内容：
## 集成步骤
### 1. 添加 Pushwoosh Cordova SDK 依赖
将 Pushwoosh Cordova SDK 依赖项添加到您的项目中：
```bash
cordova plugin add pushwoosh-cordova-plugin
```
### 2. Cordova SDK 初始化
在您的 `index.js` 文件的根组件中，将以下代码添加到 `deviceready` 事件处理程序内。请严格按照以下步骤操作：
```javascript title="index.js"
document.addEventListener('deviceready', function() {
var pushwoosh = cordova.require("pushwoosh-cordova-plugin.PushNotification");
// 1. 在初始化之前注册通知回调
document.addEventListener('push-receive', function(event) {
var notification = event.notification;
console.log("Push received: " + JSON.stringify(notification));
});
document.addEventListener('push-notification', function(event) {
var notification = event.notification;
console.log("Push opened: " + JSON.stringify(notification));
});
// 2. 初始化 Pushwoosh
pushwoosh.onDeviceReady({
appid: "__YOUR_APP_ID__"
});
// 3. 注册设备以接收推送通知
pushwoosh.registerDevice(
function(status) {
var pushToken = status.pushToken;
// 处理成功注册
},
function(status) {
// 处理注册错误
}
);
}, false);
```
其中：
- `__YOUR_APP_ID__` 是来自 Pushwoosh 控制面板的应用程序代码。
### 3. iOS 原生设置
#### 3.1 功能
要在您的项目中启用推送通知，您需要添加某些功能。
在“签名与功能”部分，添加以下功能：
- `Push Notifications`
- `Background Modes`。添加此功能后，勾选 `Remote notifications` 复选框。
如果您打算使用时效性通知（iOS 15+），还需添加 `Time Sensitive Notifications` 功能。
#### 3.2 Info.plist
在您的 `Runner/Info.plist` 中，将 `__PUSHWOOSH_DEVICE_API_TOKEN__` 键设置为 [Pushwoosh Device API Token](/zh/developer/api-reference/api-access-token/#device-api-token)：
```swift title="info.plist"
Pushwoosh_API_TOKEN
__PUSHWOOSH_DEVICE_API_TOKEN__
```
#### 3.3 消息送达跟踪
您必须向您的项目添加一个通知服务扩展目标。这对于在 iOS 上实现准确的送达跟踪和富媒体等功能至关重要。
请遵循 [原生指南的步骤](/zh/developer/pushwoosh-sdk/ios-sdk/setting-up-pushwoosh-ios-sdk/basic-integration-guide/#4-message-delivery-tracking) 来添加扩展目标并在其中添加必要的 Pushwoosh 代码。
### 4. Android 原生设置
#### 4.1 安装依赖
确保所需的依赖项和插件已添加到您的 Gradle 脚本中：
将 Google Services Gradle 插件添加到您的项目级 `build.gradle` 依赖项中：
```groovy title="android/build.gradle"
buildscript {
dependencies {
classpath 'com.google.gms:google-services:4.3.15'
}
}
```
在您的应用级 `build.gradle` 文件中应用该插件：
```groovy title="app/build.gradle"
apply plugin: 'com.google.gms.google-services'
```
#### 4.2 添加 Firebase 配置文件
将 `google-services.json` 文件放入您项目目录的 `android/app` 文件夹中。
#### 4.3 添加 Pushwoosh 元数据
在您的 `main/AndroidManifest.xml` 中，在 `` 标签内添加 [Pushwoosh Device API Token](/zh/developer/api-reference/api-access-token/#device-api-token)：
```xml title="AndroidManifest.xml"
```
> **重要提示：** 请确保在您的 Pushwoosh 控制面板中为令牌授予对正确应用的访问权限。 [了解更多](/zh/developer/api-reference/api-access-token/#edit-token)
### 5. 运行项目
1. 构建并运行项目。
2. 前往 Pushwoosh 控制面板并 [发送一条推送通知](/zh/product/messaging-channels/push-notifications/send-push-notifications/one-time-push)。
3. 您应该会在应用中看到该通知。
## 扩展集成
至此，您已经集成了 SDK，可以发送和接收推送通知。现在，让我们来探索核心功能。
### 推送通知事件监听器
在 Pushwoosh SDK 中，有两个用于处理推送通知的事件监听器：
- `push-receive` 事件在应用处于前台时收到推送通知时触发
- `push-notification` 事件在用户打开通知时触发
这些事件监听器**必须**在调用 `onDeviceReady()` **之前**注册，如 [上面的初始化步骤](#2-cordova-sdk-initialization) 所示。您可以根据需要自定义处理程序逻辑：
```javascript title="index.js"
// 在 onDeviceReady() 之前注册
document.addEventListener('push-receive', function(event) {
var message = event.notification.message;
var payload = event.notification.userdata;
console.log("Push received: " + message);
// 在此处添加您的自定义逻辑
});
document.addEventListener('push-notification', function(event) {
var message = event.notification.message;
var payload = event.notification.userdata;
console.log("Push accepted: " + message);
// 在此处添加您的自定义逻辑（例如，导航到特定屏幕）
});
```
### 用户配置
通过关注个人用户的行为和偏好，您可以提供个性化内容，从而提高用户满意度和忠诚度。
```javascript
class Registration {
afterUserLogin(user) {
// 设置用户 ID
pushwoosh.setUserId(user.getId());
// 将其他用户信息设置为 Pushwoosh 的标签
pushwoosh.setTags({
"age": user.getAge(),
"name": user.getName(),
"last_login": user.getLastLoginDate()
});
}
}
```
### 标签
标签是分配给用户或设备的键值对，允许根据偏好或行为等属性进行分段，从而实现有针对性的消息传递。
```javascript
class UpdateUser {
afterUserUpdateProfile(user) {
// 设置喜爱的类别列表
pushwoosh.setTags({
"favorite_categories": user.getFavoriteCategoriesList()
});
// 设置支付信息
pushwoosh.setTags({
"is_subscribed": user.isSubscribed(),
"payment_status": user.getPaymentStatus(),
"billing_address": user.getBillingAddress()
});
}
}
```
### 事件
事件是应用内可以跟踪的特定用户操作或发生的事情，用于分析行为并触发相应的消息或操作。
```javascript
class Registration {
// 跟踪登录事件
afterUserLogin(user) {
pushwoosh.postEvent("login", {
"name": user.getName(),
"last_login": user.getLastLoginDate()
});
}
// 跟踪购买事件
afterUserPurchase(product) {
pushwoosh.postEvent("purchase", {
"product_id": product.getId(),
"product_name": product.getName(),
"price": product.getPrice(),
"quantity": product.getQuantity()
});
}
}
```
## 故障排除
如果您在集成过程中遇到任何问题，请参阅 [支持和社区](/zh/developer/pushwoosh-sdk/support-and-community) 部分。