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

Сценарии работы push-библиотек

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

Первый запуск приложения​

При первом запуске приложения выполняются следующие действия:

  1. Библиотека получает от приложения необходимые рабочие настройки.
  2. Приложение запрашивает у пользователя разрешение на отображение push-уведомлений. Запрос может выполнить как само приложение, так и библиотека.
  3. После получения разрешения библиотека запрашивает необходимые данные у ОС и регистрирует устройство на push-сервере.
  4. После успешной регистрации библиотека передаёт приложению актуальные значения deviceUid и deviceAddress.
  5. Приложение должно передать полученные deviceUid и deviceAddress на свой backend. Эти идентификаторы используются для адресной отправки push-уведомлений на устройство.

Повторный запуск приложения​

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

подсказка

Если данные регистрации актуальны, библиотека передаёт приложению актуальные значения deviceUid и deviceAddress.

Получение push-уведомления​


Обработка уведомления в Notification Service Extension​

Обработка push-уведомления зависит от варианта интеграции библиотеки EDNAPushNE.

При базовом варианте интеграции​

  1. Библиотека обрабатывает полученное уведомление и отправляет на push-сервер подтверждение его доставки.
  2. Библиотека загружает логотип и добавляет его к отображаемому уведомлению.

При расширенном варианте интеграции​

  1. Библиотека инициализируется, получает рабочие настройки и актуальный deviceAddress.
  2. Notification Service Extension вызывает метод библиотеки для обработки полученного уведомления.
  3. Библиотека отправляет на push-сервер подтверждение получения уведомления.
  4. Если загрузка контента настроена, библиотека запрашивает содержимое уведомления на push-сервере.
  5. После получения контента библиотека отправляет на push-сервер подтверждение его загрузки.
  6. Библиотека передаёт обработанные данные уведомления в расширение для дальнейшей модификации.

Обработка уведомления основным приложением​

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

  1. Для обработки уведомления вызывается метод делегата onPushReceived.
  2. Библиотека автоматически запрашивает на push-сервере содержимое полученного уведомления.
  3. После получения содержимого вызывается метод делегата onPushMessagesReceived.

Действия приложения​


Отметка сообщения как прочитанного​

После прочтения пользователем полученного сообщения приложение может вызвать метод markAsRead.

Библиотека передает на push-сервер информацию о прочтении сообщения, после чего сообщение отмечается на сервере как прочитанное.

Сброс счётчика новых сообщений​

При открытии приложения и просмотре новых сообщений приложение может вызвать метод resetNewMessageCounter.

Библиотека передает на push-сервер запрос на обнуление счётчика новых сообщений. Одновременно сбрасывается счётчик уведомлений (badge) на иконке приложения.