Перейти к основному содержимому

Расширенная настройка библиотек

Обновлено: 2 сентября 2026

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

Настройка регистрации устройства​

Использование собственного deviceUid​

По умолчанию библиотека автоматически генерирует уникальный идентификатор устройства deviceUid.

При необходимости приложение может использовать собственный идентификатор. Для этого реализуйте метод EDNAPushLiteDelegate.getCustomDeviceUid.

Добавление постфикса к Bundle ID​

В некоторых случаях Bundle ID приложения должен отличаться от идентификатора, зарегистрированного на push-сервере.

Для этого используйте свойство EDNAPushLite.appPackagePostfix. Указанный постфикс автоматически добавляется к Bundle ID при взаимодействии библиотеки с push-сервером.

Пользовательская конфигурация push-серверов​

По умолчанию библиотеки используют встроенные конфигурации тестового и боевого окружений edna.

При необходимости можно задать собственную конфигурацию:

  • в основном приложении — реализовав метод EDNAPushLiteDelegate.getCustomUrls;
  • в Notification Service Extension — реализовав метод EDNAPushNEHelperDelegate.config.

Настройка регистрации push-уведомлений​

Отключение автоматической регистрации​

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

Такое поведение определяется свойством:

pushLite.autoRegisterForNotification = true

Если установить значение false, регистрацию необходимо выполнять самостоятельно, вызвав:

  • registerForRemoteNotification() библиотеки;
  • либо соответствующий метод UIApplication.

Использовать ручную регистрацию рекомендуется только при необходимости собственного сценария получения разрешений.


Настройка Notification Service Extension​

Передача deviceAddress без использования App Group​

При расширенном варианте интеграции EDNAPushNE значение deviceAddress можно передавать без использования App Group.

Для этого реализуйте метод deviceAddress протокола EDNAPushNEHelperDelegate, который должен возвращать значение deviceAddress, полученное основным приложением от библиотеки EDNAPushLite.


Настройка обработки уведомлений​

Переопределение UNUserNotificationCenter.delegate​

По умолчанию библиотека назначает себя делегатом UNUserNotificationCenter.

При необходимости приложение может назначить собственного делегата после инициализации библиотеки:

UNUserNotificationCenter.current().delegate = ...

В этом случае необходимо реализовать методы:

  • userNotificationCenter(_:willPresent:withCompletionHandler:);
  • userNotificationCenter(_:didReceive:withCompletionHandler:).

Полученные события следует передавать библиотеке через методы EDNAPushLite.notificationCenter.userNotificationCenter(...).


Автоматическое отображение push-уведомлений​

подсказка

Начиная с версии 3.0.9 библиотека EDNAPushNE поддерживает автоматическую загрузку контента, подтверждение его получения и отображение уведомления.

Для включения режима установите:

pushLite.useFullContentForAutodraw = true
к сведению

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

Используйте этот режим, если приложению не требуется самостоятельно обрабатывать содержимое push-сообщений.

Если используется собственная реализация Notification Service Extension совместно с EDNAPushNEHelper, необходимо подставлять значения из объекта EDNAProcessResult в UNNotificationRequest.content.

Для формирования текста уведомления параметр fullMessage должен содержать JSON в виде строки. Пример:

{
"pushNotificationText": "Оплата 999.00р Карта*9999 SHOP Баланс 9999.99р 13:00"
}
к сведению

Данные из атрибутов push-сообщения имеют приоритет над данными, переданными в fullMessage.