Хабр, привет!

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

В этой статье мы рассмотрим, как интегрировать FCM в Android-приложение на Kotlin и как настроить отправку push-уведомлений с небольшого, похожего backend, сервера, написанного на Kotlin. Вы узнаете, как подключить Firebase к вашему проекту, реализовать обработку входящих сообщений на устройстве, а также научитесь отправлять push-уведомления на выбранные устройства.

Итак, начнём. Заходим на Firebase console и создаем новый проект

На следующем шаге оставляем рекомендуемые параметры для Gemini и аналитики, выбираем аккаунт и завершаем создание проекта. Как только появилась надпись, что проект готов, приступаем к его настройке.

Для начала нужно добавить Android приложение к этому проекту:

На следующем этапе понадобятся данные приложения и подпись.

Я заранее создал пустой проект и добавил туда 3 модуля по чистой архитектуре (presentation, domain, data), чтобы создать видимость реального проекта, т.к. это могут быть как глобальные модули, так и модули внутри фичи. Сделал это не из соображений соблюдения архитектуры, а для того, чтобы показать, куда подключать зависимости и плагины, потому что в одномодульном проекте все понятно и слишком просто.

Теперь у нас есть package name приложения. С никнеймом приложения проблем не возникнет, а вот сертификат подписи сейчас сгенерируем. Следующий параграф можно пропустить тем, у кого уже есть свой keystore.

Создание keystore

Android Studio -> Build -> Generate Signed App Bundle or APK -> здесь APK или Android App Bundle, без разницы -> create new

Далее вводим все необходимые данные, указываем путь к файлу хранилища ключей для сохранения и сохраняем.

Keystore готов, далее можно самостоятельно в студии генерировать подписанный исполняемый файл.

Получение сертификата

Переходим в папку с keystore. Вместе с установкой JDK поставляется утилита keytool для генерации и работы с keystore. Через неё, кстати, можно было и keystore создать.

Команда: keytool.exe --list -v --alias ваш_алиас --keystore хранилище.jks

После нажатия enter нужно ввести пароль хранилища, а потом выведутся SHA-1 и SHA-256 сертификаты.

Возвращаемся в firebase console, вставляем SHA-1, нажимаем "register app", и теперь доступен файл google-services.json, который нужно поместить в папку модуля app.

Далее показывается инструкция по добавлению базовых зависимостей.

Плагин: id("com.google.gms.google-services") version "4.4.2" apply false

Зависимости:

//fcm  
api(platform("com.google.firebase:firebase-bom:33.14.0"))  
api("com.google.firebase:firebase-messaging")

Плагин разместим в app модуле, а зависимости в data, т.к. это не относится ни к интерфейсу, ни к бизнес-логике. Теперь заканчиваем с регистрацией приложения.

Создание firebase в android приложении

В классе Application модуля app нужно добавить инициализацию firebase:

import android.app.Application  
import com.google.firebase.FirebaseApp  

internal class App : Application() {  
    override fun onCreate() {  
        super.onCreate()  
        FirebaseApp.initializeApp(this@App)  
    }  
}

За получение данных об уведомлении отвечает FirebaseMessagingService, который будет находиться в data модуле. Вместо отправки пуш-уведомления я буду логировать его, иначе статья затянется еще и на добавление сервисов для уведомлений, а также запроса разрешения.

import android.util.Log  
import com.google.firebase.messaging.FirebaseMessagingService  
import com.google.firebase.messaging.RemoteMessage  
  
class MyFirebaseMessagingService : FirebaseMessagingService() {  
  
    override fun onMessageReceived(message: RemoteMessage) {  
        Log.e(  
            "fcm",  
            "title=${message.notification?.title}" +  
                    "\ntext=${message.notification?.body}"  
        )  
    }  
  
    override fun onNewToken(token: String) {  
        super.onNewToken(token)  
        Log.e("fcm", "token=$token")  
    }  
}

В манифест app модуля добавляю декларацию этого сервиса так, чтобы google сервисы могли вызвать его через intent-фильтр:

<service  android:name="ru.vafeen.data.MyFirebaseMessagingService"  
    android:exported="false">  
  <intent-filter>        
    <action android:name="com.google.firebase.MESSAGING_EVENT" />  
  </intent-filter>
</service>

Итак, после запуска приложения в logcat необходимо найти токен устройства и скопировать.

Тестирование

Протестируем работу fcm без бэкенда. На главной странице проекта в firebase console в категории run есть раздел messaging, где можно отправить тестовое сообщение.

Далеепо нажатию на кнопку «create your first compaign» выберем «Firebase Notification messages», которое приходит вне зависимости от нахождения в приложении.

На этом шаге задаем заголовок и текст уведомления.

Далее «Send test message», вставляем туда скопированный токен и нажимам «Test».

Результат:

Работа с Android-частью закончена, переходим к «бэкенду».

Backend

В этом же проекте, для простоты и удобства, я создам обычный Java or Kotlin Library модуль.

Здесь нужно настроить Firebase Admin SDK, чтобы отправлять сообщения.

Зависимость: implementation("com.google.firebase:firebase-admin:9.2.0")

Теперь сгенерируем Service Account key, по которому происходит отправка сообщений. Firebase Console -> Project settings -> Service Accounts -> generate new private key -> generate key -> сохраняем в удобное место

Также здесь сразу даётся сниппет для инициализации SDK: копируем его.

Далее инициализируем SDK, получаем инстанс FCM, создаем сообщение и отправляем его. Токен — харкдод, т. к. это не полноценный бэкенд, и его отправка выходит за рамки статьи.

import com.google.auth.oauth2.GoogleCredentials 
import com.google.firebase.FirebaseApp  
import com.google.firebase.FirebaseOptions  
import com.google.firebase.messaging.FirebaseMessaging 
import com.google.firebase.messaging.Message  
import com.google.firebase.messaging.Notification  
import java.io.FileInputStream  
  
const val token = "токен девайса"  
  
fun main() {  
    initialFirebase()  
    val fcm = FirebaseMessaging.getInstance()  
    val message = Message.builder().setNotification(  
    Notification.builder().setTitle("test sdk title").setBody("test sdk text").build()  
).setToken(token).build()
    println(fcm.send(message))  
}  
  
fun initialFirebase() {  
    val serviceAccount = FileInputStream("path/to/serviceAccountKey.json")  

    val options = FirebaseOptions.builder()  
        .setCredentials(GoogleCredentials.fromStream(serviceAccount))  
        .build()  
  
    FirebaseApp.initializeApp(options)  
  
}

А также при запуске бэкенд потребует логирование. Здесь просто происходит чек наличия, поэтому на настройке не будем останавливаться.

Добавляем зависимость: implementation("ch.qos.logback:logback-classic:1.5.18")

И снова запуск.

На этом путь от пустого проекта до отправки fcm с имитированного бэкенда пройден!

No errors, no warnings, gentlemen and ladies!

FCM для Android и Backend на Kotlin