Настройка FCM
Подключите Firebase Cloud Messaging, чтобы отправлять уведомления Android из проекта DK Push.
1. Подготовьте Firebase
Создайте или выберите проект Firebase для приложения Android. Убедитесь, что Firebase Cloud Messaging включён и приложение получает токен FCM через push-плагин или Firebase SDK.
В консоли Firebase откройте «Настройки проекта» → «Сервисные аккаунты» → «Создать новый закрытый ключ». Скачайте JSON сервисного аккаунта этого проекта и храните его в секрете.
2. Добавьте учётные данные в DK Push
Откройте проект, затем «Подключение» → «Android / Firebase». Добавьте учётные данные FCM, укажите название и вставьте полный JSON сервисного аккаунта. После сохранения провайдер станет активным.
DK Push проверяет структуру JSON и хранит учётные данные на сервере в зашифрованном виде. API не возвращает исходный текст. Приложение получает только ограниченный ключ SDK / Client проекта, а не ключ сервисного аккаунта Firebase.
Проверка учётных данных FCM выполняется локально и не доказывает, что Google примет уведомление. Для проверки всей цепочки отправьте тестовый пуш.
3. Зарегистрируйте устройство Android
Создайте ключ SDK / Client с правом devices:write, получите актуальный токен FCM в приложении и вызовите регистрацию устройства с platform ANDROID и pushToken.provider FCM. Проверьте устройство и активный токен в разделе «Устройства».
4. Отправьте и проверьте ошибки
Отправьте уведомление на устройство через «Тестовое уведомление». Статус принятия означает, что FCM принял запрос, но не подтверждает показ уведомления системой. Проверьте устройство и разрешение на уведомления.
Изображение кампании должно быть доступно по публичному HTTPS-адресу. DK Push передаёт его в FCM как изображение уведомления там, где Android поддерживает расширенный формат. Отсутствующее или некорректное изображение пропускается и не блокирует push.
Маленькая статусная иконка Android — это drawable внутри APK, а не удалённое изображение. DK Push не задаёт это поле, чтобы Firebase или установленный push-плагин использовал стандартную иконку приложения. Добавьте и настройте подходящий монохромный drawable в Android-сборке, иначе Android может показать стандартный круг. Изображение кампании не заменяет эту маленькую иконку.
- Нет устройства: проверьте ID проекта, права клиентского ключа, ответ регистрации и доступ приложения к сети.
- Нет активного токена: получите новый токен FCM и повторите регистрацию; токены могут меняться.
- Ошибка провайдера: проверьте, что сервисный аккаунт относится к проекту Firebase приложения и что API FCM включён.
- Запрос принят, но уведомления нет: проверьте разрешение Android, состояние приложения, сеть устройства и обработку уведомлений в плагине.