Настройка бейджей

Примечание

Чтобы настроить бейджи для плагинов Cordova или React Native, обратитесь к соответствующим руководствам:

• Бейджи для Cordova
• Бейджи для React Native

Начиная с версии 6.4.0 Pushwoosh iOS SDK, процесс управления и установки бейджей через push-уведомления изменился.

Если вы ранее использовали номер бейджа для отображения количества полученных push-уведомлений в вашем приложении, вам необходимо перейти на более новую версию iOS SDK (6.4.0 или более позднюю). Старые версии будут поддерживаться до конца второго квартала 2022 года.

Как настроить бейджи

Чтобы настроить бейджи, выполните следующие шаги:

1. Добавьте Notification Service Extension (File -> New -> Target…)

2. Выберите “Notification Service Extension”

3. Замените сгенерированный класс NotificationService подклассом PushwooshNotificationServiceExtension. Pushwoosh берет на себя подсчет бейджей, событие доставки, загрузку вложений и обработку тайм-аута:

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. Добавьте ID App Group в info.plist основного приложения:

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

Расширение наследует это значение от хост-приложения, поэтому вам не нужно повторять его в info.plist расширения — добавляйте его туда только для переопределения значения хоста.

Если вы предпочитаете не использовать файл info.plist, укажите App Group в коде, переопределив pushwooshAppGroupsName в вашем классе NotificationServiceExtension:

Swift

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

Objective-C

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

Пример

Отправка push-уведомления с бейджами

Если вы хотите отправить push-уведомление с бейджами из Pushwoosh Control Panel, просто добавьте желаемое значение бейджа в текстовое поле badges, как показано на рисунке ниже:

Примечание

Вы можете использовать следующие форматы значений для корректной отправки бейджей: +1, -1 или 5. Если вы хотите увеличить значение бейджа, используйте знак ”+”, если вы хотите уменьшить значение бейджа, используйте знак ”-”. Вы также можете установить точное число, используя, например, 5 без знака.

Поделитесь с нами своим мнением

Ваши отзывы помогают нам улучшать наш продукт, поэтому мы будем рады, если вы поделитесь с нами любыми проблемами, возникшими в процессе интеграции SDK. Если вы столкнетесь с какими-либо трудностями, пожалуйста, не стесняйтесь поделиться своими мыслями с нами через эту форму.