iOS SDK 7.0+: руководство по расширенной интеграции

В этом разделе представлена информация о расширенной интеграции Pushwoosh iOS SDK.

Фоновые режимы

Осторожно

По умолчанию iOS не позволяет приложениям обрабатывать push-уведомления, когда они находятся в фоновом режиме. Это относится и к тихим push-уведомлениям, которые полезны для обновления данных приложения без взаимодействия с пользователем.

Чтобы включить эту функциональность, необходимо добавить в проект фоновые режимы (Background Modes).

Шаги по включению фоновых режимов

1. Откройте свой проект в Xcode и выберите его в Project Navigator.
2. Выберите таргет вашего приложения на левой панели.
3. Перейдите на вкладку Signing & Capabilities.
4. Нажмите кнопку + Capability в левом верхнем углу.
5. Найдите и выберите Background Modes из списка.
6. В разделе Background Modes включите Remote notifications, установив соответствующий флажок.

После этого ваше приложение сможет обрабатывать push-уведомления, в том числе тихие, во время работы в фоновом режиме.

Режимы переднего плана

По умолчанию Pushwoosh iOS SDK отображает баннер уведомления, когда приложение работает на переднем плане.

Вы можете управлять этим поведением, установив следующий логический флаг в вашем коде (например, в AppDelegate):

Swift

// Установите false, чтобы отключить уведомления на переднем плане, true — чтобы включить
Pushwoosh.configure.showPushnotificationAlert = true

Пример (Swift)

Objective-C

// Установите 0, чтобы отключить уведомления на переднем плане, 1 — чтобы включить
[[Pushwoosh configure] setShowPushnotificationAlert:0];

Пример (Objective-C)

Уровень логирования

Pushwoosh iOS SDK поддерживает следующие уровни логирования:

• NONE — логи от SDK не выводятся.
• ERROR — в консоли отображаются только сообщения об ошибках.
• WARNING — помимо ошибок, отображаются предупреждения.
• INFO — включает информационные сообщения (настройка по умолчанию).
• DEBUG — включает подробную отладочную информацию.

По умолчанию уровень логирования установлен на INFO, что гарантирует предоставление SDK релевантной информации без загромождения консоли разработчика.

Чтобы изменить уровень логирования, обновите ключ Pushwoosh_LOG_LEVEL в файле Info.plist вашего приложения:

<key>Pushwoosh_LOG_LEVEL</key>
<string>YOUR_LOG_LEVEL</string>

Кроме того, вы можете изменить уровень логирования с помощью приведенного ниже фрагмента кода:

Pushwoosh.Debug.setLogLevel(.PW_LL_DEBUG)

Замените YOUR_LOG_LEVEL на желаемый уровень (например, DEBUG или ERROR).

Пользовательский UNNotificationCenterDelegate

Если вы хотите использовать свой собственный UNNotificationCenterDelegate (например, для локальных уведомлений), вы должны сообщить об этом Pushwoosh SDK для корректной работы. Вы можете сделать это с помощью свойства notificationCenterDelegateProxy экземпляра Pushwoosh:

Swift

Pushwoosh.configure?.notificationCenterDelegateProxy.add(my_delegate)

Пример (Swift)

Objective-C

[Pushwoosh.configure.notificationCenterDelegateProxy addNotificationCenterDelegate:my_delegate];

Пример (Objective-C)

Затем реализуйте методы UNNotificationCenterDelegate в вашем делегате:

Swift

func userNotificationCenter(
    _ center: UNUserNotificationCenter,
    willPresent notification: UNNotification,
    withCompletionHandler completionHandler: @escaping (UNNotificationPresentationOptions) -> Void
) {
    if (!PWMessage.isPushwooshMessage(notification.request.content.userInfo)) {
        // Обработайте ваше уведомление
        completionHandler(UNNotificationPresentationOptions.alert)
    }
}

func userNotificationCenter(
    _ center: UNUserNotificationCenter,
    didReceive response: UNNotificationResponse,
    withCompletionHandler completionHandler: @escaping () -> Void
) {
    if (!PWMessage.isPushwooshMessage(response.notification.request.content.userInfo)) {
        // Обработайте ваше уведомление
        completionHandler()
    }
}

Пример (Swift)

Objective-C

- (void)userNotificationCenter:(UNNotificationCenter *)center
        willPresentNotification:(UNNotification *)notification
        withCompletionHandler:(void (^)(UNNotificationPresentationOptions options))completionHandler {
    if (![PWMessage isPushwooshMessage:notification.request.content.userInfo]) {
        // Обработайте ваше сообщение
        completionHandler(UNNotificationPresentationOptionAlert);
    }
}

- (void)userNotificationCenter:(UNNotificationCenter *)center
        didReceiveNotificationResponse:(UNNotificationResponse *)response
        withCompletionHandler:(void (^)(void))completionHandler {
    if (![PWMessage.isPushwooshMessage:response.notification.request.content.userInfo]) {
        // Обработайте ваше сообщение
        completionHandler();
    }
}

Пример (Objective-C)

Отложенная инициализация Pushwoosh

Флаг Pushwoosh_LAZY_INITIALIZATION предотвращает автоматическую инициализацию Pushwoosh SDK при запуске приложения. Это позволяет лучше контролировать, когда запускаются сервисы Pushwoosh SDK.

Когда этот флаг включен, Pushwoosh SDK не запускает свои сервисы до тех пор, пока не будут явно вызваны методы Pushwoosh iOS SDK.

Добавьте следующую запись в Info.plist:

<key>Pushwoosh_LAZY_INITIALIZATION</key>
<true/>

Сценарии использования

1. Контролируемая инициализация SDK – флаг Pushwoosh_LAZY_INITIALIZATION позволяет отложить запуск Pushwoosh SDK, предоставляя больше контроля над тем, когда активируются push-сервисы.

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

3. Пользовательская конфигурация push-уведомлений – некоторые приложения могут требовать настройки параметров push-уведомлений в зависимости от предпочтений пользователя или настроек учетной записи. При отложенной инициализации Pushwoosh SDK запускается только после определения соответствующей конфигурации.

Полный список свойств Info.plist

Свойство	Описание	Возможные значения
Pushwoosh_APPID	Устанавливает ID приложения Pushwoosh для production-сборки.	XXXXX-XXXXX Тип: String
Pushwoosh_APPID_Dev	Устанавливает ID приложения Pushwoosh для development-сборки.	XXXXX-XXXXX Тип: String
Pushwoosh_SHOW_ALERT	Показывает уведомление на переднем плане.	YES (по умолчанию) / NO Тип: Boolean
Pushwoosh_ALERT_TYPE	Устанавливает стиль уведомления.	BANNER (по умолчанию) / ALERT / NONE Тип: String
Pushwoosh_BASEURL	Переопределяет базовый URL сервера Pushwoosh.	https://cp.pushwoosh.com/json/1.3/ (по умолчанию) Тип: String
Pushwoosh_AUTO_ACCEPT_DEEP_LINK_FOR_SILENT_PUSH	Если YES, диплинки, полученные в тихих push-уведомлениях, будут обрабатываться автоматически.	YES (по умолчанию) / NO Тип: Boolean
Pushwoosh_ALLOW_SERVER_COMMUNICATION	Позволяет SDK отправлять сетевые запросы на серверы Pushwoosh.	YES (по умолчанию) / NO Тип: Boolean
Pushwoosh_ALLOW_COLLECTING_DEVICE_DATA	Позволяет SDK собирать и отправлять на сервер данные об устройстве (версия ОС, локаль и модель).	YES (по умолчанию) / NO Тип: Boolean
Pushwoosh_ALLOW_COLLECTING_DEVICE_OS_VERSION	Позволяет SDK собирать и отправлять на сервер версию ОС устройства.	YES (по умолчанию) / NO Тип: Boolean
Pushwoosh_ALLOW_COLLECTING_DEVICE_LOCALE	Позволяет SDK собирать и отправлять на сервер локаль устройства.	YES (по умолчанию) / NO Тип: Boolean
Pushwoosh_ALLOW_COLLECTING_DEVICE_MODEL	Позволяет SDK собирать и отправлять на сервер модель устройства.	YES (по умолчанию) / NO Тип: Boolean
Pushwoosh_LOG_LEVEL	Уровень логирования Pushwoosh SDK. Подробнее см. в разделе Уровень логирования.	NONE / ERROR / WARNING / INFO (по умолчанию) / DEBUG / VERBOSE Тип: String
Pushwoosh_PURCHASE_TRACKING_ENABLED	Позволяет SDK отслеживать встроенные покупки. Необходимо для Customer Journey Builder.	YES / NO (по умолчанию) Тип: Boolean