Настройка Firebase (FCM) для push-уведомлений
Как подключить Firebase Cloud Messaging к приложению Revs App: создать проект, загрузить service-account JSON и иконку уведомления. Обязательный шаг перед отправкой push.
Push-уведомления в Revs App работают через Firebase Cloud Messaging (FCM) - бесплатный сервис Google для отправки уведомлений. Это разовая настройка: подключаете Firebase один раз, дальше отправляете уведомления из панели или по API.
Сервис Google, который доставляет push-уведомления на устройства Android и iOS. Revs App использует его как «почтальона»: вы пишете текст уведомления в панели, а FCM доставляет его пользователям.
Что понадобится
- бесплатный аккаунт Google;
- проект в Firebase Console;
- 10-15 минут на первичную настройку.
Шаг 1. Создайте проект Firebase
- Зайдите в Firebase Console и создайте новый проект.
- Внутри проекта зарегистрируйте приложение с вашим Package Name (тем же, что в разделе Основное).
- Firebase выдаст файл конфигурации
google-services.json- он нужен для сборки Android с поддержкой push.
Шаг 2. Загрузите service-account JSON
Чтобы Revs App мог отправлять уведомления от вашего имени, нужен ключ доступа к проекту:
- В настройках проекта Firebase откройте раздел Service accounts (сервисные аккаунты).
- Сгенерируйте приватный ключ - скачается файл service-account JSON.
- В Revs App откройте Push-уведомления → Настройки и загрузите этот JSON.
Шаг 3. Иконка уведомления
В настройках push можно задать иконку, которая показывается в шторке уведомлений на Android.
Требование: PNG ровно 96×96 px. Иконка требует пересборки приложения.
После настройки
Когда Firebase подключён, можно:
- отправлять уведомления вручную;
- планировать рассылки;
- отправлять адресные push по API - например, при оформлении заказа на сайте.
Советы
- Храните service-account JSON в секрете - это ключ доступа к отправке уведомлений.
- Для iOS-пушей дополнительно потребуется ключ APNs из вашего аккаунта Apple Developer - без него уведомления на iPhone доставляться не будут.
Возможные ошибки
| Сообщение | Решение |
|---|---|
| «Файл слишком большой. Ожидается service-account JSON.» | Загружаете не тот файл - нужен именно service-account JSON из Firebase. |
| «Нужен PNG ровно 96×96» | Иконка уведомления должна быть строго 96×96 px в PNG. |
| Уведомления не приходят | Проверьте, что JSON и google-services.json из одного проекта, а приложение пересобрано. |
