Copy page

Android SDK

Упрощенная интеграция Android

Эта инструкция описывает упрощенную интеграцию Mindbox SDK в нативное Android-приложение. Она подходит для быстрой настройки push-уведомлений без ручной реализации логики их получения и обработки.

Когда подходит упрощенная интеграция

Используйте упрощенную схему, если:

• приложение подключает Mindbox SDK впервые и существующей интеграции нет;
• нужно быстро запустить push для MVP или тестового сценария;
• не планируется совместное использование сторонних push-провайдеров;
• важно минимизировать работу с нативным кодом.

Что поддерживается

• Получение пушей через FCM / Huawei Push Kit / RuStore Push (в зависимости от подключенного провайдера);
• Автоматическая регистрация токена устройства после инициализации;
• Показ уведомлений с каналом и иконкой приложения;
• Открытие приложения по клику на push — переход на главный экран (поведение по умолчанию);
• Доступ к payload и URL из push при клике в него — можно реализовать кастомный переход;
• Отправка операций из приложения: sendAsyncOperation / sendSyncOperation;
• Показ in-app уведомлений, настроенных в Mindbox.

Что не поддерживается

• Центр уведомлений (ЦУ) и сложные сценарии коммуникации;
• Совместное использование со сторонними push-SDK без доработок;
• Встроенная собственная навигация по клику — для нее потребуется переход на стандартную интеграцию.

Шаг 1. Добавьте и инициализируйте SDK

1. В android/build.gradle добавьте репозиторий и зависимости SDK:

   Code
   dependencies {
       ...
       implementation 'cloud.mindbox:mobile-sdk:{версия}'  
       //Если планируете интегрировать мобильные пуши Firebase, Huawei, RuStore
       //добавьте соответствующие зависимости:
       implementation 'cloud.mindbox:mindbox-firebase'  # since 2.10.0
       implementation 'cloud.mindbox:mindbox-huawei'  # since 2.10.0
       implementation 'cloud.mindbox:mindbox-rustore'  # since 2.12.0
      ...
   }

   Актуальные версии SDK.

   Начиная с версии 2.15.5 модули mindbox-firebase и mindbox-firebase-starter добавляют в манифест приложения разрешение AD_ID. Если приложение публикуется в Google Play, проверьте декларации в Play Console — подробнее в разделе Разрешение AD_ID.

2. Создайте или обновите класс MainApplication и проинициализируйте SDK:

   Code
   import android.app.Application
   import cloud.mindbox.mobile_sdk.*
   
   class MainApplication: Application() {
       override fun onCreate() {
           super.onCreate()
   
           Mindbox.init(application, configuration, listOf())
   
       }
   }

   SDK автоматически зарегистрируется для получения токенов и пушей. Инициализацию можно вынести в отдельный метод, если она должна выполняться при первом запуске приложения.

Шаг 2. Подключите провайдеров

---

Шаг 3. Настройте уведомления

Канал уведомлений

Переопределите значения в android/app/src/main/res/values/strings.xml:

Code
<string name="mindbox_default_channel_id">client_channel_id</string>
<string name="mindbox_default_channel_name">Client Notifications</string>
<string name="mindbox_default_channel_description">Client Push notifications</string>

Иконка уведомления

Добавьте файл mindbox_notification_small_icon в android/app/src/main/res/drawable/. Требования:

• Формат: PNG или XML (вектор);
• Монохромная, прозрачный фон;
• Используется в статус-баре.

Шаг 4. Настройте обработку событий

По умолчанию при клике пуш открывает главную активность приложения. Если нужна собственная логика — добавьте обработчик. Подробнее: Обработка клика по push на Android.

Пример обработки:

Code
import cloud.mindbox.mobile_sdk.*

class MainActivity : AppCompatActivity() {

    private fun processMindboxIntent(intent: Intent?) {
        // Добавляем событие клика по push-уведомлению
        intent?.let { Mindbox.onPushClicked(this, it) }
        Mindbox.onNewIntent(intent)
    }

    override fun onNewIntent(intent: Intent?) {
        super.onNewIntent(intent)
        processMindboxIntent(intent)
    }

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        processMindboxIntent(intent)
        
        // ...
    }

    // ...
}

Доступные методы SDK: