# 3.1. Отправка push-notifications через Firebase
:::warning{title=" Убедитесь, что эти шаги выполнены успешно:"}

 * <Link to="https://developers.mindbox.ru/docs/add-android-integration">Настройка точек интеграции для Android приложения</Link>
 * <Link to="https://developers.mindbox.ru/docs/firebase-key-setup">Получение Firebase ключей для Android-приложения</Link>
 * [Добавление SDK в приложение](https://developers.mindbox.ru/docs/add-android-sdk)
 * [Инициализация SDK](https://developers.mindbox.ru/docs/android-sdk-initialization)
:::

:::tip{title="Результат шага «Отправка push-notifications на Android через Firebase»:"} 

 Push-уведомление отправляется из Mindbox и отображается на устройстве. Проверить, что push-уведомления отправляются, можно с помощью [этой инструкции](https://developers.mindbox.ru/docs/mobile-push-check).
:::

:::info
<Link to="https://github.com/mindbox-cloud/android-sdk/blob/develop/example/app/src/main/java/com/mindbox/example/MindboxFirebaseMessagingService.kt#L9-L52">Пример реализации отображения уведомлений Firebase</Link>
:::

## 1. Сделайте интеграцию вашего приложения с Firebase

import AndroidPushFirebaseFirstStep from '/src/_AndroidPushFirebaseFirstStep.mdx';

<AndroidPushFirebaseFirstStep />

В файле MainActivity.kt:

```kotlin title="Kotlin"

private val requestPermissionLauncher =
    registerForActivityResult(ActivityResultContracts.RequestPermission()) { isGranted ->
        if (isGranted) {
            Mindbox.updateNotificationPermissionStatus(this)
        }
    }
 if (ContextCompat.checkSelfPermission(
                applicationContext,
                Manifest.permission.POST_NOTIFICATIONS
            ) != PackageManager.PERMISSION_GRANTED
        ) {
            requestPermissionLauncher.launch(Manifest.permission.POST_NOTIFICATIONS)
        }
```

import AndroidFirebaseShowNotificationsRealization from '/src/_AndroidFirebaseShowNotificationsRealization.mdx';

<AndroidFirebaseShowNotificationsRealization />

## 4. Доработайте метод инициализации, чтобы push-уведомления отображались всегда

:::info 
[Пример инициализации](https://github.com/mindbox-cloud/android-sdk/blob/develop/example/app/src/main/java/com/mindbox/example/ExampleApplication.kt#L34)
:::

### 4.1 Добавьте библиотеку для обработки push-уведомлений

В файл app/build.gradle в блок dependencies (Module: app). Лучше указать фиксированную версию, чтобы контролировать обновление. Актуальную версию вы можете посмотреть [на странице библиотеки в Maven Central](https://central.sonatype.com/artifact/cloud.mindbox/mindbox-firebase/2.5.1-rc/versions).

```groovy title="build.gradle"
dependencies {
   ...
    implementation 'cloud.mindbox:mobile-sdk:{версия}' 
    implementation 'cloud.mindbox:mindbox-firebase'
   ...
}
```

Начиная с версии 2.15.5 модуль `mindbox-firebase` добавляет в манифест приложения разрешение `AD_ID`. Если приложение публикуется в Google Play, проверьте декларации в Play Console — подробнее в разделе [Разрешение AD_ID](https://developers.mindbox.ru/docs/add-android-sdk#%D1%80%D0%B0%D0%B7%D1%80%D0%B5%D1%88%D0%B5%D0%BD%D0%B8%D0%B5-ad_id).

### 4.2 Укажите библиотеку в методе инициализации

В методе `Mindbox.init`, который должен быть размещен в коллбэке onCreate вашего приложения, нужно указать, что в этой сборке используется MindboxFirebase.

```kotlin title="Kotlin"
import cloud.mindbox.mobile_sdk.Mindbox
import cloud.mindbox.mobile_sdk.MindboxConfiguration
import cloud.mindbox.mindbox_firebase.MindboxFirebase

class MyApplication : Application() {
   override fun onCreate() {
     super.onCreate()
     // ....

     // Было
     // Mindbox.init(applicationContext, configuration, listOf())

     // Нужно
     Mindbox.init(applicationContext, configuration, listOf(MindboxFirebase))

     // ...
   }
 }
```

Добавьте в коллбэк onCreate вашего приложения вызов метода `Mindbox.initPushServices`.

```kotlin title="Kotlin"
import cloud.mindbox.mobile_sdk.Mindbox
import cloud.mindbox.mindbox_firebase.MindboxFirebase
class MyApplication : Application() {
  override fun onCreate() {
        super.onCreate()
        // ....
        Mindbox.initPushServices(applicationContext, listOf(MindboxFirebase))
        Mindbox.init(applicationContext, configuration, listOf(MindboxFirebase))
        // ...
    }
}
```

## 5. Используйте отдельное Firebase-приложение для push-токена (опционально)

:::info

Доступно начиная с версии SDK 2.15.3.

:::

Этот шаг нужен, если в приложении используется несколько SDK, которые работают с push-уведомлениями через Firebase. Такие SDK могут перезаписать общий FCM-токен, из-за чего push-уведомления Mindbox перестанут доходить.

Если этой проблемы у вас нет, раздел можно пропустить, все будет работать как раньше.

### Как это работает

Mindbox создаст собственный изолированный инстанс Firebase (named-приложение) со своим FCM-токеном. Сторонние SDK на него не влияют, и пуши Mindbox доходят стабильно.

### Как включить

1. Уберите `Mindbox.updatePushToken` из `onNewToken` в созданном `FirebaseMessagingService`.
2. В файл `res/values/strings.xml` добавьте ресурс `mindbox_firebase_app_name` (значение может быть любым):

  ```xml title="res/values/strings.xml"
  <resources>
  <string name="mindbox_firebase_app_name">mindbox-named</string>
  </resources>
  ```

  Этого достаточно: Mindbox сам создаст named-приложение и будет брать токен из него.

3. Если включен resource shrinking, добавьте его в исключения, чтобы ресурс не вырезали из release-сборки. Создайте или дополните файл res/raw/keep.xml:

  ```xml title="res/raw/keep.xml"
  <resources xmlns:tools="http://schemas.android.com/tools"
        tools:keep="@string/mindbox_firebase_app_name" />
  ```

### Обратите внимание

* **`onNewToken` использовать не нужно — уберите его.** Для named-приложения Firebase его не вызывает (только для основного приложения).
* **Токен обновится сам.** Если токен сменится, Mindbox передаст новый при следующем открытии или сворачивании/разворачивании приложения. Если нужно передать раньше, сделайте это вручную:

  ```kotlin
  `Mindbox.updatePushToken(context, token, MindboxFirebase)`.
  ```

:::tip{title="Проверьте результат шага «Отправка push-notifications через Firebase»:"}

 Из Mindbox отправляется мобильное push-уведомление, и оно отображается на устройстве.

 Проверить, что push-уведомления отправляются, можно с помощью [этой инструкции](https://developers.mindbox.ru/docs/mobile-push-check#%D0%BF%D1%80%D0%BE%D0%B2%D0%B5%D1%80%D0%B8%D1%82%D1%8C-%D1%87%D1%82%D0%BE-%D0%BC%D0%BE%D0%B1%D0%B8%D0%BB%D1%8C%D0%BD%D0%BE%D0%B5-push-%D1%83%D0%B2%D0%B5%D0%B4%D0%BE%D0%BC%D0%BB%D0%B5%D0%BD%D0%B8%D0%B5-%D0%BE%D1%82%D0%BF%D1%80%D0%B0%D0%B2%D0%BB%D1%8F%D0%B5%D1%82%D1%81%D1%8F).
:::
