Firebase: push, Remote Config и Crashlytics

01Как на самом деле работают push-уведомления

Ваш сервер никогда не общается с телефоном напрямую. На iOS операционная система держит одно соединение с APNs (Apple Push Notification service); на Android Google Play services держит одно соединение с FCM. При запуске приложение запрашивает у ОС токен устройства — адрес этого приложения на этом устройстве — и отправляет его на ваш бэкенд с привязкой к пользователю. Чтобы уведомить пользователя, бэкенд вызывает FCM HTTP v1 API с этим токеном; FCM доставляет сообщение напрямую на Android и передаёт его в APNs для iOS (APNs auth key один раз загружается в Firebase). Токены меняются: после переустановки, восстановления или периодически, поэтому подписывайтесь на обновление токена и обновляйте его на бэкенде. Когда FCM сообщает, что токен unregistered, удаляйте его. У одного пользователя может быть несколько устройств, поэтому храните несколько токенов на пользователя.

• Токен устройства: адрес одной установки приложения, а не человека
• APNs auth key (.p8), загруженный в Firebase для доставки на iOS
• FCM HTTP v1 API с сервисным аккаунтом; legacy API больше нет
• Topics: одно сообщение многим подписчикам (например, 'promo-hy')

02Разрешения и получение токена

На iOS для показа уведомлений всегда нужно разрешение пользователя, а на Android начиная с Android 13 (API 33) нужно runtime-разрешение POST_NOTIFICATIONS. Если пользователь нажал «Не разрешать», спросить ещё раз обычно нельзя — ему придётся идти в Настройки. Поэтому спрашивайте в момент, когда польза очевидна: после первого заказа («Сообщить, когда ваш кофе будет готов?»), а не на первом экране. Перед системным диалогом покажите короткое пояснение внутри приложения. iOS также поддерживает provisional authorization, при которой уведомления тихо попадают в центр уведомлений без запроса. С React Native Firebase поток такой: запросить разрешение, получить токен, отправить его в ваш API вместе с платформой и версией приложения и подписаться на обновление токена.

1import { getMessaging, requestPermission, getToken, onTokenRefresh,
2  AuthorizationStatus } from "@react-native-firebase/messaging";
3import { PermissionsAndroid, Platform } from "react-native";
4 
5export async function registerForPush(api: Api) {
6  const messaging = getMessaging();
7  if (Platform.OS === "android" && Platform.Version >= 33) {
8    await PermissionsAndroid.request("android.permission.POST_NOTIFICATIONS");
9  }
10  const status = await requestPermission(messaging);
11  if (status === AuthorizationStatus.DENIED) return;
12 
13  const token = await getToken(messaging);
14  await api.post("/devices", { token, platform: Platform.OS });
15  onTokenRefresh(messaging, (t) => api.post("/devices", { token: t, platform: Platform.OS }));
16}

03Notification и data сообщения, foreground и нажатия

Сообщение FCM может содержать блок notification (title, body), блок data (ваши собственные строки ключ-значение) или оба. Notification-сообщения ОС показывает автоматически, когда приложение в фоне или закрыто. Data-only сообщения доставляются вашему коду, который решает, что делать; на iOS это фоновые push, которые система может ограничивать или задерживать, поэтому никогда не полагайтесь на них для видимых пользователю оповещений. Когда приложение на переднем плане (foreground), ОС по умолчанию не показывает баннер: вы получаете сообщение в onMessage и решаете сами — показать toast внутри приложения, обновить бейдж или вывести локальное уведомление через Notifee. Обрабатывайте нажатия в трёх состояниях: foreground, фон (onNotificationOpenedApp) и холодный старт (getInitialNotification). Кладите маршрут deep link в data и навигируйте по нему.

1{
2  "message": {
3    "token": "DEVICE_TOKEN",
4    "notification": { "title": "Order ready", "body": "Your latte is waiting at the counter" },
5    "data": { "type": "order_status", "orderId": "1042", "link": "app://orders/1042" },
6    "android": { "priority": "high", "notification": { "channel_id": "orders" } },
7    "apns": { "payload": { "aps": { "sound": "default" } } }
8  }
9}

04Надёжная отправка с бэкенда

Отправляйте push из воркера очереди, а не внутри HTTP-запроса: изменение статуса заказа записывает задачу, а воркер вызывает FCM с повторами и backoff. Используйте Firebase Admin SDK или эндпоинт HTTP v1 с учётными данными сервисного аккаунта, которые хранятся как секрет на сервере, — никогда не в приложении. Сохраняйте каждую кампанию или сообщение и в собственной базе данных, чтобы приложение могло показывать внутренний inbox; доставка push не гарантирована, а пользователи их смахивают. Учитывайте тихие часы и настройки пользователя (обновления заказов включены, маркетинг выключен), а на Android создавайте отдельные каналы уведомлений, чтобы пользователи могли заглушить акции, не теряя обновлений заказов. Удаляйте токены, которые FCM возвращает как unregistered. Для массовых кампаний используйте topics или пакетную отправку и планируйте их через собственную систему задач.

05Remote Config: принудительное обновление, техработы, feature flags

Remote Config — это набор параметров ключ-значение в Firebase, которые приложение получает во время работы. Вы поставляете значения по умолчанию внутри приложения, при запуске делаете fetch и activate с разумным минимальным интервалом запроса и читаете значения как boolean, числа или строки. Условия позволяют таргетировать по платформе, версии приложения, стране или проценту пользователей. Три сценария окупаются сами. Принудительное обновление: храните min_supported_version для каждой платформы; если установленная версия ниже, показывайте блокирующий экран со ссылкой на стор — это необходимо, когда старое приложение сломается на новом API. Режим техработ: флаг, который показывает дружелюбный экран во время миграций. Feature flags и постепенный rollout: включите новый checkout для 10% пользователей, посмотрите на Crashlytics, затем доведите до 100%. Логика должна оставаться безопасной, если fetch не удался: приложение обязано работать на значениях по умолчанию.

1import { getRemoteConfig, setDefaults, setConfigSettings,
2  fetchAndActivate, getValue } from "@react-native-firebase/remote-config";
3import { Platform } from "react-native";
4import DeviceInfo from "react-native-device-info";
5 
6export async function checkAppGate() {
7  const rc = getRemoteConfig();
8  await setDefaults(rc, { min_version_ios: "1.0.0", min_version_android: "1.0.0", maintenance: false });
9  await setConfigSettings(rc, { minimumFetchIntervalMillis: 15 * 60 * 1000 });
10  await fetchAndActivate(rc).catch(() => undefined); // offline: use cached/defaults
11 
12  const key = Platform.OS === "ios" ? "min_version_ios" : "min_version_android";
13  if (getValue(rc, "maintenance").asBoolean()) return "maintenance";
14  if (isLower(DeviceInfo.getVersion(), getValue(rc, key).asString())) return "force_update";
15  return "ok";
16}

06Crashlytics и Analytics

Crashlytics собирает нативные падения, а с React Native Firebase — и JavaScript-ошибки, которые вы записываете, группируя их по проблемам и привязывая к версии приложения и устройству. Следите, чтобы файлы символов (dSYM на iOS, mapping-файлы на Android) загружались во время сборки, иначе стек-трейсы останутся нечитаемыми. Добавляйте контекст: задайте неперсональный ID пользователя, пишите breadcrumbs перед рискованными шагами (начало оплаты, возврат с оплаты) и записывайте обработанные ошибки от важных сбоев API. Следите за долей пользователей без падений (crash-free users) по каждому релизу; во время поэтапного rollout это ваш сигнал поставить его на паузу. Analytics записывает события вроде screen_view, add_to_cart, begin_checkout и purchase. До написания кода определите небольшой план событий с единообразными именами, не отправляйте персональные данные и учитывайте согласие: отключайте сбор данных, пока пользователь не согласится, там, где этого требует закон.

07Как устроена доставка: priority, TTL, collapsing и Doze

Доставку определяет управление питанием. Режим Doze в Android группирует сетевые обращения неактивных телефонов: FCM-сообщения с normal priority ждут окна обслуживания, а сообщения с high priority могут разбудить устройство. Google может понизить приоритет приложениям, чьи high-priority сообщения не приводят к видимому уведомлению, поэтому используйте high priority только для уведомлений, которые пользователь увидит. На iOS apns-priority 10 означает «доставить сейчас», а 5 — «доставить, когда удобно»; фоновые push (content-available) должны использовать priority 5 и ограничиваются системой. У каждого сообщения есть время жизни: android.ttl и заголовок apns-expiration определяют, как долго сервис пытается достучаться до офлайн-устройства. Collapse key (Android) или apns-collapse-id (iOS) заменяет более старые недоставленные сообщения самым новым, поэтому телефон, вернувшийся в сеть, покажет одно сообщение «корзина обновлена», а не десять. Держите payload маленьким: FCM отклоняет сообщения больше примерно 4 KB.

1{
2  "message": {
3    "token": "DEVICE_TOKEN",
4    "data": { "type": "cart_sync", "cartId": "c_981" },
5    "android": { "priority": "normal", "ttl": "3600s", "collapse_key": "cart" },
6    "apns": {
7      "headers": {
8        "apns-priority": "5",
9        "apns-push-type": "background",
10        "apns-collapse-id": "cart"
11      },
12      "payload": { "aps": { "content-available": 1 } }
13    }
14  }
15}

08Отправка в масштабе: батчи, ошибки и квоты

Firebase Admin SDK отправляет список до 500 токенов за один вызов через sendEachForMulticast и возвращает по одному результату на токен в том же порядке. Классифицируйте каждую ошибку. registration-token-not-registered означает, что приложение удалено или токен сменился: удалите его. invalid-argument означает, что ваш payload неверен: исправьте код, не повторяйте отправку. Quota-exceeded (HTTP 429) и ошибки unavailable или internal (503, 500) временные: повторяйте с экспоненциальным backoff и учитывайте заголовок Retry-After. Квоты на уровне проекта существуют, поэтому крупные кампании должны идти через очередь, которая дозирует отправку, а не через цикл, который отправляет всё сразу. Дозирование защищает и ваш бэкенд: если 200,000 человек получат акцию в одну и ту же секунду, многие откроют приложение в одну и ту же минуту.

1import { getMessaging } from "firebase-admin/messaging";
2 
3export async function sendToUser(tokens: string[], title: string, body: string, link: string) {
4  const res = await getMessaging().sendEachForMulticast({
5    tokens, // up to 500 per call
6    notification: { title, body },
7    data: { link },
8  });
9 
10  const dead = res.responses
11    .map((r, i) => (r.error?.code === "messaging/registration-token-not-registered" ? tokens[i] : null))
12    .filter((t): t is string => t !== null);
13 
14  await removeTokens(dead); // keep the token table clean
15  return { sent: res.successCount, failed: res.failureCount };
16}

09Приватность и безопасность уведомлений

Уведомление показывается на экране блокировки, дублируется на часы и иногда зачитывается вслух, поэтому считайте его текст публичным. Никогда не кладите в заголовок или текст одноразовые коды, балансы, сведения о здоровье или полные адреса; пишите «По вашему заказу есть обновление» и показывайте подробности внутри приложения после аутентификации. На iOS Notification Service Extension может расшифровать зашифрованный payload или загрузить rich media перед показом (mutable-content), что позволяет передавать через серверы Apple и Google меньше чувствительных данных. Учётные данные service account, которыми отправляются push, дают много прав: выдавайте ему только нужные роли Firebase Cloud Messaging, храните его в secret store и регулярно ротируйте. Токены устройств — не секреты, но это персональные данные, связанные с пользователем: отвязывайте их при выходе из аккаунта и удаляйте при удалении аккаунта.

10Устройство Remote Config и подводные камни

Remote Config — это конфигурация на стороне клиента, а не граница безопасности: значения скачиваются на устройство, и там их можно прочитать или изменить, поэтому никогда не храните в нём секреты и не используйте его для выдачи прав — доступ должен проверять сервер. SDK кэширует значения и ограничивает частоту fetch; минимальный интервал fetch по умолчанию — 12 часов, поэтому уменьшайте его осознанно и не делайте fetch на каждом экране. Решите, как значения активируются: fetchAndActivate при запуске — это просто, но может изменить UI уже после его появления; fetch в фоне и активация при следующем запуске позволяют избежать мерцания. Real-time Remote Config может отправлять изменения в запущенные приложения, когда нужны быстрые kill-switch. Процентные условия стабильны для каждой установки приложения, поэтому один и тот же пользователь остаётся в одной группе. Каждая публикация создаёт версию шаблона, на которую можно откатиться, — это полезно, когда неудачное значение что-то ломает.