Как Firebase отправляет Push-уведомления?

Как Firebase отправляет Push-уведомления?

Firebase Cloud Messaging (FCM) — это кросс-платформенный сервис для отправки push-уведомлений на устройства iOS, Android и веб-приложения. Механизм отправки уведомлений через FCM представляет собой сложную, но хорошо организованную систему, состоящую из нескольких ключевых компонентов и этапов.

Ключевые компоненты системы FCM

1. Firebase Cloud Messaging Backend — центральный сервер Google/Firebase, который управляет регистрацией устройств, маршрутизацией и отправкой сообщений.
2. APNs (Apple Push Notification service) — собственный сервис push-уведомлений Apple. Для iOS устройств FCM не отправляет сообщения напрямую, а использует APNs как транспорт.
3. FCM SDK — библиотека, интегрированная в клиентское приложение (iOS), которая регистрирует устройство и получает сообщения.
4. Ваш сервер приложения (или Firebase Console/Admin SDK) — источник, который инициирует отправку уведомления.

Процесс отправки уведомления на iOS устройство

Рассмотрим полный цикл от регистрации устройства до получения уведомления.

1. Регистрация устройства в FCM и получение токенов

При первом запуске приложения с интегрированным FCM SDK происходит двухэтапная регистрация:

// Пример кода для получения токенов в iOS приложении
import FirebaseMessaging

Messaging.messaging().token { token, error in
  if let error = error {
    print("Ошибка получения FCM токена: \(error)")
  } else if let token = token {
    print("FCM Registration Token: \(token)")
    // Этот токен необходимо отправить на ваш backend сервер для дальнейшей работы
  }
}

• Приложение регистрируется в APNs и получает уникальный APNs Device Token.
• FCM SDK передает этот APNs токен в FCM Backend, который в ответ генерирует и возвращает свой собственный FCM Registration Token (также называемый "токеном устройства"). Этот FCM токен является основным идентификатором устройства для отправки уведомлений через Firebase.

2. Сохранение токена на вашем сервере

Полученный FCM Registration Token необходимо сохранить в базе данных вашего backend сервера. Это ключ для адресации сообщений конкретному устройству или группе устройств.

3. Инициация отправки уведомления

Уведомление можно отправлять:

• Из Firebase Console (для тестирования и простых сценариев).
• С помощью Firebase Admin SDK на вашем сервере.
• Через HTTP или XMPP API FCM напрямую с вашего сервера.

Пример отправки через Admin SDK (Node.js):

const admin = require('firebase-admin');

// Инициализация Firebase Admin SDK
admin.initializeApp({
  credential: admin.credential.applicationDefault()
});

const message = {
  token: 'FCM_REGISTRATION_TOKEN_RECEIVED_FROM_DEVICE', // Ключевой идентификатор
  notification: {
    title: 'Новое сообщение',
    body: 'Вам пришло новое сообщение в чате!'
  },
  data: {
    customKey: 'customValue' // Полезная нагрузка для обработки внутри приложения
  },
  apns: {
    payload: {
      aps: {
        'content-available': 1 // Специфичные для iOS параметры
      }
    }
  }
};

// Отправка сообщения
admin.messaging().send(message)
  .then((response) => {
    console.log('Уведомление успешно отправлено:', response);
  })
  .catch((error) => {
    console.log('Ошибка отправки:', error);
  });

4. Маршрутизация через FCM Backend и APNs

Это самый важный этап:

1. Ваш сервер отправляет запрос на FCM Backend, передавая FCM Registration Token и содержимое сообщения.
2. FCM Backend принимает запрос, валидирует токен и, используя внутреннюю связь, преобразует FCM Registration Token в соответствующий APNs Device Token, который он сохранил при регистрации.
3. FCM Backend формирует окончательное push сообщение в строгом формате, требуемом Apple (APNs payload), и отправляет его на серверы APNs.
4. APNs получает сообщение, проверяет его валидность (включая certificates/provisioning профили приложения) и напрямую доставляет уведомление на целевое iOS устройство.

5. Обработка уведомления на устройстве

На устройстве уведомление может быть обработано в двух сценариях:

• Приложение не активно (закрыто или в background): Система iOS отображает уведомление на экране (alert, banner, sound). При тапе на уведомление запускается приложение.
• Приложение активно (в foreground): Уведомление может быть обработано напрямую через делегат.

// Обработка уведомления, когда приложение в foreground (iOS 10+)
func userNotificationCenter(_ center: UNUserNotificationCenter,
                            willPresent notification: UNNotification,
                            withCompletionHandler completionHandler: @escaping (UNNotificationPresentationOptions) -> Void) {
  let userInfo = notification.request.content.userInfo
  // Анализ данных из userInfo (включая data payload от FCM)
  print("Получено уведомление: \(userInfo)")
  // Решение о том, как показать уведомление (например, только звук)
  completionHandler([.sound])
}

Типы сообщений и особенности

• Notification Messages: Автоматически обрабатываются FCM SDK и отображаются системой. Используются для видимых alert.
• Data Messages: Передаются напрямую в приложение, даже если оно в background, и требуют специальной обработки для отображения. Используются для синхронизации данных.
• Комбинированные сообщения: Содержат обе части. На iOS, если приложение в background, сначала будет показана notification часть, а data часть будет доступна после открытия приложения.

Ключевые выводы

Для iOS разработчика важно понимать, что Firebase выступает как промежуточный слой (proxy) между вашим сервером и APNs. Основные технические сложности (поддержание постоянного соединения с миллионами устройств, масштабирование) решаются инфраструктурой Google. Однако для успешной работы необходимо:

1. Правильно настроить сертификаты и provisioning профили для APNs в проекте Firebase и в вашем приложении.
2. Своевременно обновлять FCM Registration Token на вашем сервере (токен может меняться при переустановке приложения, очистке данных и т.д.).
3. Различать обработку notification и data payload в клиентском приложении для корректной логики.

Таким образом, процесс отправки push-уведомлений через Firebase на iOS является надежным и масштабируемым, но требует четкого соблюдения архитектуры, предусмотренной Apple и Google.