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

Интеграция push-библиотек в iOS-приложение

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

В этой статье описана пошаговая интеграция библиотек EDNAPushLite и EDNAPushNE в iOS-приложение.

EDNAPushLite интегрируется в основное приложение и обеспечивает регистрацию устройства, получение и обработку push-уведомлений и push-сообщений. EDNAPushNE интегрируется в расширение Notification Service Extension и используется для обработки push-уведомлений перед их отображением пользователю.

подсказка

Для совместной работы библиотек передавайте deviceAddress из основного приложения в Notification Service Extension. Для этого рекомендуется использовать App Group, который позволяет автоматически обмениваться deviceAddress между приложением и расширением.

File IconВозможности библиотек

Перед началом​

Перед началом интеграции убедитесь, что у вас есть:

  • iOS-приложение, в которое необходимо интегрировать push-сервис edna;
  • проект приложения в Xcode;
  • доступ к Apple Developer Account; Apple Developer Account
  • возможность создавать и настраивать App ID, App Group и Notification Service Extension;
  • библиотеки EDNAPushLite и EDNAPushNE.

Шаг 1. Создайте App Group​

к сведению

App Group используется для обмена данными между основным приложением и Notification Service Extension. В рамках интеграции push-библиотек группа позволяет автоматически передавать значение deviceAddress из EDNAPushLite в EDNAPushNE.

  1. В Apple Developer Account перейдите в раздел Certificates, Identifiers & Profiles → Identifiers → App Groups. Apple Developer Account

  2. Создайте новую группу.

  3. Укажите идентификатор группы в поле Identifier. Рекомендуется использовать в качестве идентификатора группы Bundle ID приложения, например:

    group.com.mycompany.myapp
  4. Сохраните идентификатор группы — он потребуется далее при настройке проекта, Notification Service Extension и библиотек.

Шаг 2. Создайте Notification Service Extension в Xcode​

к сведению

Notification Service Extension запускается при получении push-уведомления и позволяет обрабатывать его до отображения пользователю, не запуская основное приложение.

  1. Добавьте новый Target в проект: File → New → Target.
  2. Выберите тип расширения Notification Service Extension.
  3. В окне Choose options for your new target укажите notificationService в поле Product Name.
  4. В окне Activate “notificationService” scheme? нажмите Activate, чтобы активировать схему расширения.

Шаг 3. Подключите EDNAPushLite​

Библиотеку EDNAPushLite можно подключить к проекту одним из следующих способов:

Для подключения библиотеки через Swift Package Manager укажите адрес репозитория:

https://github.com/edna-ru/push-lite-ios

Шаг 4. Подключите EDNAPushNE​

Библиотеку EDNAPushNE можно подключить к проекту одним из следующих способов:

Для подключения библиотеки через Swift Package Manager укажите адрес репозитория:

https://github.com/edna-ru/push-ne-ios

Настройка Info.plist​

  1. Для обмена данными между основным приложением и Notification Service Extension добавьте в файлы Info.plist приложения и расширения строковый параметр edna_app_group.

    подсказка

    По умолчанию библиотеки получают идентификатор App Group из параметра edna_app_group. При необходимости его можно задать программно с помощью свойства appGroup при инициализации библиотеки.

    Пример настройки:

    <key>edna_app_group</key>
    <string>group.com.mycompany.myapp</string>
  2. В файл Info.plist расширения Notification Service Extension также добавьте логический параметр edna_use_test_mode.

    • false — использование боевого сервера (значение по умолчанию);
    • true — использование тестового сервера.

    Пример настройки:

    <key>edna_use_test_mode</key>
    <true/>

Шаг 5. Интегрируйте EDNAPushLite​

На этом этапе необходимо настроить библиотеку EDNAPushLite в основном приложении. Для этого внесите изменения в файл AppDelegate.swift.

Инициализация библиотеки​

Добавьте импорт библиотеки EDNAPushLite, примите классом AppDelegate протокол EDNAPushLiteDelegate и объявите свойства для хранения экземпляра библиотеки и регистрационных данных устройства.

В методе application(_:didFinishLaunchingWithOptions:) настройте свойства библиотеки и вызовите метод start().

import EDNAPushLite

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate, EDNAPushLiteDelegate {
var pushService: EDNAPushLite!
var deviceUid: String?
var deviceAddress: String?

func application(
_ application: UIApplication,
didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
) -> Bool {
let pushLite = EDNAPushLite(delegate: self)
pushLite.appGroup = "group.com.mycompany.myapp"
pushLite.logEnable = true
pushLite.useFullContentForAutodraw = false
pushLite.autoRegisterForNotification = true

pushService = pushLite
pushService.start()

return true
}
}

Передача системных вызовов​

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

func application(
_ application: UIApplication,
didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data
) {
pushService.appDelegate.didRegisterForRemoteNotifications(withDeviceToken: deviceToken)
}

func application(
_ application: UIApplication,
didFailToRegisterForRemoteNotificationsWithError error: Error
) {
pushService.appDelegate.didFailToRegisterForRemoteNotifications(withError: error)
}

func application(
_ application: UIApplication,
didReceiveRemoteNotification userInfo: [AnyHashable: Any],
fetchCompletionHandler completionHandler: @escaping (UIBackgroundFetchResult) -> Void
) {
pushService.appDelegate.didReceiveRemoteNotification(
userInfo,
fetchCompletionHandler: completionHandler
)
}

Обработка регистрационных данных​

В методе isProduction укажите контур, который должна использовать библиотека:

  • false — тестовый;
  • true — боевой.

В методах didStarted и onActualDeviceAddress обработайте регистрационные данные устройства.

После регистрации библиотека предоставляет:

  • deviceUid — идентификатор устройства;
  • deviceAddress — адрес устройства для доставки push-уведомлений.

В методе onActualDeviceAddress также можно получить дополнительную информацию об устройстве с помощью метода getDeviceInfo().

Полученные deviceUid, deviceAddress и deviceInfo необходимо передать на backend приложения.

func isProduction(pushApi: EDNAPushLite) -> Bool {
#if DEBUG
return false
#else
return true
#endif
}

func didStarted(pushApi: EDNAPushLite, configResult: EDNAPushLiteConfigResult) {
self.deviceUid = configResult.deviceUid
}

func onActualDeviceAddress(
pushApi: EDNAPushLite,
deviceAddress: String,
isChanged: Bool
) {
self.deviceAddress = deviceAddress
let deviceInfo = pushApi.getDeviceInfo()
// TODO: передать deviceAddress, deviceUid и deviceInfo на backend приложения
}

Обработка push-уведомлений​

Для обработки входящих push-уведомлений и push-сообщений реализуйте методы делегата onPushReceived и onPushMessagesReceived.

func onPushReceived(pushApi: EDNAPushLite, pushData: EDNAPushData) {
// Код обработки push-уведомления
}

func onPushMessagesReceived(pushApi: EDNAPushLite, messages: [EDNAPushMessage]) {
for message in messages {
// Код обработки push-сообщения
}
}

Шаг 6. Интегрируйте EDNAPushNE​

Библиотеку EDNAPushNE можно интегрировать в Notification Service Extension одним из двух способов:

Базовый вариант требует минимальных изменений кода. Библиотека автоматически обрабатывает push-уведомления, сообщает об их получении на push-сервер и загружает логотип, предоставленный сервисом «Красивый чек» или переданный в параметре logoURL.

подсказка

Рекомендуется для стандартного сценария интеграции.

File IconОбзор модуля «Красивый чек»

В файле NotificationService.swift импортируйте библиотеку EDNAPushNE и добавьте следующий код:

import UserNotifications
import EDNAPushNE

class NotificationService: UNNotificationServiceExtension {
override func didReceive(
_ request: UNNotificationRequest,
withContentHandler contentHandler: @escaping (UNNotificationContent) -> Void
) {
EDNAPushNE.didReceive(request, withContentHandler: contentHandler)
}

override func serviceExtensionTimeWillExpire() {
EDNAPushNE.serviceExtensionTimeWillExpire()
}
}

При необходимости дополнительной обработки уведомления реализуйте ее в блоке, передаваемом в метод EDNAPushNE.didReceive.

warning

Блок обработки должен завершаться вызовом contentHandler. В противном случае уведомление будет отображено только после истечения времени, отведенного системой на обработку Notification Service Extension.

Пример изменения заголовка уведомления:

override func didReceive(
_ request: UNNotificationRequest,
withContentHandler contentHandler: @escaping (UNNotificationContent) -> Void
) {
EDNAPushNE.didReceive(request, withContentHandler: { content in
let bestAttemptContent = content.mutableCopy() as! UNMutableNotificationContent
bestAttemptContent.title = "Modified title"
contentHandler(bestAttemptContent)
})
}