Подключение Firebase
Для отправки push-уведомлений через Firebase необходимо подключить Firebase Cloud Messaging (FCM), зарегистрировать приложение и добавить в проект необходимые файлы конфигурации.
Подключение Firebase к проекту
-
В Android Studio откройте Tools → Firebase → Cloud Messaging → Set up Firebase Cloud Messaging.
Android Studio — Android Developers -
В открывшейся панели нажмите Add FCM to your app и подтвердите внесение изменений в проект, чтобы подключить Firebase Assistant.
-
Поместите файл
google-services.jsonв каталог приложения рядом с файломbuild.gradle.подсказкаФайл
google-services.jsonможно запросить у специалистов edna или самостоятельно сформировать в консоли Firebase.
Регистрация приложения в Firebase
Для настройки Firebase выберите подходящий вариант в зависимости от используемой учётной записи:
- edna — если используется учётная запись edna;
- Firebase — если используется собственный проект Firebase.
- edna
- Firebase
-
Получите SHA-256 fingerprint сертификата приложения. Пример:
keytool-list-v-keystore «файл сертификата», Certificate fingerprints. -
Передайте специалистам edna appPackage приложения и SHA-256 fingerprint сертификата.
-
Получите сформированный файл конфигурации
google-services.json. -
В Android Studio переключитесь в представление Project и скопируйте файл
google-services.jsonв каталог приложения рядом сbuild.gradle.
Android Studio — Android Developers
- Зарегистрируйте проект в Firebase.
- Добавьте Android-приложение.
- Получите JSON-файл сервисного аккаунта Google.
- Передайте его специалистам edna.
Получение JSON-файла сервисного аккаунта Google
Сообщения по протоколу Firebase HTTP V1 отправляются с использованием OAuth 2.0. Для генерации токенов доступа требуется JSON-файл сервисного аккаунта Google.
- После перехода на HTTP V1 один JSON-файл используется для всех приложений в рамках одного проекта Firebase.
- Облако не поддерживает вложенные структуры в
message.data.
Шаг 1. Активируйте Firebase Cloud Messaging API
-
Откройте консоль Firebase и выберите проект.
Firebase Console -
Перейдите в раздел Cloud Messaging.
-
Убедитесь, что Firebase Cloud Messaging API (V1) имеет статус Enabled.
-
Если API отключён, откройте меню и активируйте его.
Шаг 2. Создайте сервисный аккаунт
-
Перейдите в консоль Google Cloud → Service Accounts и выберите проект.
Google Cloud Console -
Нажмите Create service account и заполните поля:
- Service account name;
- Service account ID;
- Description.
-
Нажмите Create and continue.
Шаг 3. Назначьте роли
-
Предоставьте сервисному аккаунту следующие роли:
-
Service Account Token Creator;
-
Firebase Cloud Messaging API Admin.
подсказкаДля быстрого поиска ролей используйте фильтр firebase.
-
-
После назначения ролей нажмите Done.
Шаг 4. Получите JSON-файл
- Выберите созданный сервисный аккаунт.
- Перейдите на вкладку Keys.
- Нажмите Add key → Create new key.
- Выберите тип ключа JSON.
- Нажмите Create — после этого JSON-файл будет автоматически загружен.
Для подключения канала передайте в edna скачанный JSON-файл сервисного аккаунта и App Package приложения.
Хра ните 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>
Сообщения, отправленные через платформу edna, могут поступать в одном из следующих форматов:
- JSON;
- строка (
STRING); - строка в формате Base64.
Для Huawei Push формат зависит от версии библиотеки:
- Base64 — для версий ниже 3.10.0;
STRING— начиная с версии 3.10.0.
При реализации обработки рекомендуется поддерживать оба варианта формата сообщений.