Mindbox
Android SDK

3.2. Отправка push-notifications через Huawei

Результат шага «Отправка push-notifications через Huawei»:

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

Проверить, что push-уведомления отправляются, можно с помощью этой инструкции.

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

Из официальной инструкции по добавлению Huawei нужны следующие пункты:

  • зарегистрировать свое приложение в AppGallery;
  • интегрируйте HMS Core SDK.

Для удобства можете воспользоваться набором инструментов HMS Toolkit.

После того, как эти шаги сделаны, можно переходить к реализации сервиса, который будет отвечать за получение токенов и push-уведомлений.

android/app/build.gradle
dependencies { implementation 'com.huawei.hms:push:6.13.0.300' ... }

Если в вашем приложении указан targetSdk 33, то для получения уведомлений вам также нужно добавить разрешение (подробнее тут, пример реализации тут)

В файле AndroidManifest.xml:

KotlinKotlin
<uses-permission android:name="android.permission.POST_NOTIFICATIONS"/>

В файле MainActivity.kt:

KotlinKotlin
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) }

2. Реализовать отображение уведомлений

Базовая интеграция

Подходит, если не требуется кастомная логика.

Самостоятельная интеграция

Подходит, если требуется кастомная логика для самостоятельной отрисовки push-уведомлений.

Для выбора поведения при ошибке загрузки картинок или для написания собственной логики используйте метод setMessageHandling

3. Зарегистрируйте сервис обработку push-уведомлений в AndroidManifest.xml

Добавьте в файл AndroidManifest.xml следующие пункты:

XMLXML
<application ...> ... <service android:name=".MindboxHuaweiMessagingService" android:exported="false"> <intent-filter> <action android:name="com.huawei.push.action.MESSAGING_EVENT"/> </intent-filter> </service> ... </application> <queries> <intent> <action android:name="com.huawei.hms.core.aidlservice" /> </intent> </queries>

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

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

В файл app/build.gradle в блок dependencies (Module: app). Лучше указать фиксированную версию, чтобы контролировать обновление. Актуальную версию вы можете посмотреть на странице библиотеки в Maven Central.

Начиная с версии 2.10.0 не нужно указывать фиксированную версию huawei, вместо этого следует:

implementation 'cloud.mindbox'

build.gradle
dependencies { ... implementation 'cloud.mindbox:mobile-sdk:{версия}' implementation 'cloud.mindbox:mindbox-huawei' # since 2.10.0 ... }

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

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

KotlinKotlin
import cloud.mindbox.mobile_sdk.Mindbox import cloud.mindbox.mobile_sdk.MindboxConfiguration import cloud.mindbox.mindbox_firebase.MindboxHuawei class MyApplication : Application() { override fun onCreate() { super.onCreate() // .... // Было // Mindbox.init(applicationContext, configuration, listOf()) // Нужно Mindbox.init(applicationContext, configuration, listOf(MindboxHuawei)) // ... } }

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

KotlinKotlin
import cloud.mindbox.mobile_sdk.Mindbox import cloud.mindbox.mindbox_huawei.MindboxHuawei class MyApplication : Application() { override fun onCreate() { super.onCreate() // .... Mindbox.initPushServices(applicationContext, listOf(MindboxHuawei)) Mindbox.init(applicationContext, configuration, listOf(MindboxHuawei)) // ... } }

5. Настройка получения статусов сообщений

Huawei предоставляет сервис для получения статусов по отправленным сообщениям. Мы с ним интегрированы, и за счет этого можем быстрее и точнее получать информацию о том, что происходит с отправкой push-уведомлений.

Для его использования вам нужно:

  1. Открыть консоль AppGallery;
  2. Перейти в раздел Push Kit;
  3. Открыть вкладку «Настройки»;
  4. Выбрать ваше приложение.
  5. В разделе «Подтверждение приложения» выключить режим передачи статусов;

  1. Добавить наш домен;

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

Нажать "Изменить" в блоке "Настройка отправки мобильных пушей Android".

Скопировать адрес домена, который вы увидите в информационной панели.

  1. Нажать «Отправить». Статусы в нашей системе начнут обрабатываться автоматически.

Проверьте результат шага «Отправка push-notifications через Huawei»:

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

Проверить, что push-уведомления отправляются, можно с помощью этой инструкции.

Last modified on