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

Подключение Firebase

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

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

Подключение Firebase к проекту​

  1. В Android Studio откройте Tools → Firebase → Cloud Messaging → Set up Firebase Cloud Messaging. Android Studio — Android Developers

  2. В открывшейся панели нажмите Add FCM to your app и подтвердите внесение изменений в проект, чтобы подключить Firebase Assistant.

  3. Поместите файл google-services.json в каталог приложения рядом с файлом build.gradle.

    подсказка

    Файл google-services.json можно запросить у специалистов edna или самостоятельно сформировать в консоли Firebase.

Регистрация приложения в Firebase​

Для настройки Firebase выберите подходящий вариант в зависимости от используемой учётной записи:

  • edna — если используется учётная запись edna;
  • Firebase — если используется собственный проект Firebase.
  1. Получите SHA-256 fingerprint сертификата приложения. Пример:

    keytool-list-v-keystore «файл сертификата», Certificate fingerprints.
  2. Передайте специалистам edna appPackage приложения и SHA-256 fingerprint сертификата.

  3. Получите сформированный файл конфигурации google-services.json.

  4. В Android Studio переключитесь в представление Project и скопируйте файл google-services.json в каталог приложения рядом с build.gradle. Android Studio — Android Developers

Получение JSON-файла сервисного аккаунта Google​

Сообщения по протоколу Firebase HTTP V1 отправляются с использованием OAuth 2.0. Для генерации токенов доступа требуется JSON-файл сервисного аккаунта Google.

к сведению
  • После перехода на HTTP V1 один JSON-файл используется для всех приложений в рамках одного проекта Firebase.
  • Облако не поддерживает вложенные структуры в message.data.

Шаг 1. Активируйте Firebase Cloud Messaging API​

  1. Откройте консоль Firebase и выберите проект. Firebase Console

  2. Перейдите в раздел Cloud Messaging.

  3. Убедитесь, что Firebase Cloud Messaging API (V1) имеет статус Enabled.

  4. Если API отключён, откройте меню и активируйте его.

Шаг 2. Создайте сервисный аккаунт​

  1. Перейдите в консоль Google Cloud → Service Accounts и выберите проект. Google Cloud Console

  2. Нажмите Create service account и заполните поля:

    • Service account name;
    • Service account ID;
    • Description.
  3. Нажмите Create and continue.

Шаг 3. Назначьте роли​

  1. Предоставьте сервисному аккаунту следующие роли:

    • Service Account Token Creator;

    • Firebase Cloud Messaging API Admin.

      подсказка

      Для быстрого поиска ролей используйте фильтр firebase.

  2. После назначения ролей нажмите Done.

Шаг 4. Получите JSON-файл​

  1. Выберите созданный сервисный аккаунт.
  2. Перейдите на вкладку Keys.
  3. Нажмите Add key → Create new key.
  4. Выберите тип ключа JSON.
  5. Нажмите Create — после этого JSON-файл будет автоматически загружен.
подсказка

Для подключения канала передайте в edna скачанный JSON-файл сервисного аккаунта и App Package приложения.

warning

Храните JSON-файл в защищённом месте. При его утрате потребуется создать новый ключ, восстановить существующий невозможно.

Обработка уведомлений из нескольких источников​

Если приложение получает push-уведомления не только через платформу edna, но и из других сервисов, необходимо настроить обработку следующих событий:

  • обновление Firebase Token;
  • получение входящих уведомлений.

Шаг 1. Создайте класс-наследник FcmPushService​

Создайте класс, наследующий com.edna.android.push_lite.fcm.FcmPushService, и переопределите методы onNewToken() и onMessageReceived().

import androidx.core.app.NotificationManagerCompat;
import com.edna.android.push_lite.fcm.FcmPushService;
import com.google.firebase.messaging.RemoteMessage;

public class PushFcmIntentCustomService extends FcmPushService {

@Override
public void onNewToken(String s) {
// Обработка токена в прочих целях
super.onNewToken(s);
}

@Override
public void onMessageReceived(RemoteMessage message) {
boolean isEdnaPush = true;

// Если Push относится к edna
if (isEdnaPush && NotificationManagerCompat.from(this).areNotificationsEnabled()) {
super.onMessageReceived(message);
} else {
// Обработка уведомления в прочих целях
}
}
}

Шаг 2. Зарегистрируйте сервис​

Добавьте созданный сервис в раздел <application> файла AndroidManifest.xml.

<service
android:name=".push.PushFcmIntentCustomService"
android:exported="false">

<intent-filter>
<action android:name="com.google.firebase.MESSAGING_EVENT" />
</intent-filter>

</service>
warning

Сообщения, отправленные через платформу edna, могут поступать в одном из следующих форматов:

  • JSON;
  • строка (STRING);
  • строка в формате Base64.

Для Huawei Push формат зависит от версии библиотеки:

  • Base64 — для версий ниже 3.10.0;
  • STRING — начиная с версии 3.10.0.

При реализации обработки рекомендуется поддерживать оба варианта формата сообщений.