设置 Badges

注意

要为 Cordova 或 React Native 插件设置 Badges，请参阅相应的指南：

• Cordova Badges
• React Native Badges

从 Pushwoosh iOS SDK 6.4.0 版本开始，通过推送通知管理和设置 Badges 的过程已发生变化。

如果您之前使用 Badges 数量来表示应用程序中收到的推送通知数量，则必须迁移到新版本的 iOS SDK（6.4.0 或更高版本）。旧版本将支持到 2022 年第二季度末。

如何设置 Badges

要设置 Badges，请按照以下步骤操作：

1. 添加 Notification Service Extension (File -> New -> Target…)

2. 选择 “Notification Service Extension”

3. 将生成的 NotificationService 类替换为 PushwooshNotificationServiceExtension 的子类。Pushwoosh 会为您处理 Badge 计数、送达事件、附件下载以及超时回退：

Swift

import PushwooshFramework

class NotificationService: PushwooshNotificationServiceExtension {}

Objective-C

#import <PushwooshFramework/PushwooshFramework.h>

@interface NotificationService : PushwooshNotificationServiceExtension
@end

@implementation NotificationService
@end

4. 将 App Groups 功能添加到两个目标 — 主应用和 Notification Service Extension — 并为每个目标使用相同的 App Group。

5. 将 App Group ID 添加到主应用的 info.plist 中：

<key>PW_APP_GROUPS_NAME</key>
<string>group.com.example.demoapp_example</string>

扩展程序会从宿主应用继承此值，因此您无需在扩展程序的 info.plist 中重复此值 — 仅在需要覆盖宿主值时才在此处添加。

如果您不想使用 info.plist 文件，可以通过在您的 NotificationServiceExtension 类中覆盖 pushwooshAppGroupsName 来在代码中提供 App Group：

Swift

override func pushwooshAppGroupsName() -> String? {
    "group.com.example.demoapp_example"
}

Objective-C

- (NSString *)pushwooshAppGroupsName {
    return @"group.com.example.demoapp_example";
}

示例

发送带 Badges 的推送通知

如果您想从 Pushwoosh Control Panel 发送带 Badges 的推送通知，只需将所需的 Badge 值添加到 badges 文本字段中，如下图所示：

注意

您可以使用以下值格式来正确发送 Badges：+1、-1 或 5。 如果要增加 Badge 值，请使用 “+” 符号**，如果要减少 Badges，请使用 “-” 符号。** 您也可以通过使用例如不带符号的 5 来设置确切的数字。

与我们分享您的反馈

您的反馈有助于我们创造更好的体验，因此如果您在 SDK 集成过程中遇到任何问题，我们很乐意听取您的意见。如果您遇到任何困难，请随时通过此表单与我们分享您的想法。