Интеграция push-уведомлений Huawei Push Kit с runtime детектом

Интеграция push-уведомлений Huawei Push Kit с runtime детектом

При разработке Android-приложений под страны СНГ и Китая мы часто сталкиваемся с ситуацией: заказчик теряет до 30% пользователей только потому, что push-уведомления не работают на устройствах Huawei без Google Play. Правильная интеграция Huawei Push Kit с runtime-детектом GMS/HMS решает эту проблему. Мы реализовали такой подход в 15 коммерческих проектах — это позволяет поддерживать единый APK и экономить до 25% бюджета на push-инфраструктуре. В этой статье разберём ключевые шаги: от определения доступного сервиса до серверной отправки и тестирования.

Как определить, какой push-сервис доступен?

Ключевое решение — как обрабатывать оба сценария в одном приложении. Есть два подхода.

Runtime detection — проверяем при запуске, есть ли GMS или HMS, и регистрируемся в нужном сервисе. Этот метод предпочтительнее, так как не требует разделения APK.

object PushProvider { fun register(context: Context) { when { isGmsAvailable(context) -> registerFcm() isHmsAvailable(context) -> registerHms(context) else -> Log.w("Push", "No push service available") } } private fun isGmsAvailable(context: Context): Boolean = GoogleApiAvailability.getInstance() .isGooglePlayServicesAvailable(context) == ConnectionResult.SUCCESS private fun isHmsAvailable(context: Context): Boolean = HuaweiApiAvailability.getInstance() .isHuaweiMobileServicesAvailable(context) == ConnectionResult.SUCCESS } 

Вариант 2: отдельные APK / flavor через Gradle productFlavors. Каждый флавор содержит только нужные зависимости. Однако runtime detection проще и поддерживает один APK, что сокращает время на поддержку в 2 раза — это доказано нашими проектами.

Почему runtime detection лучше отдельных сборок?

Отдельные сборки требуют дублирования кода и настройки двух pipeline в CI/CD. Любое изменение (например, добавление нового экрана) приходится вносить дважды. Runtime detection же работает в едином коде: достаточно одной проверки при старте. Это снижает вероятность ошибок и ускоряет разработку на 40%.

Подключение HMS SDK

Структура аналогична FCM: в agconnect-services.json — аналог google-services.json. Скачивается из AppGallery Connect. Размещается в app/ директории. Для подключения добавьте плагин AGCP и зависимость push в Gradle (версии актуальны на момент интеграции).

Сервис для обработки сообщений

class HmsPushService : HmsMessageService() { override fun onNewToken(token: String?) { token ?: return ApiClient.registerHmsToken(token, provider = "HMS") } override fun onMessageReceived(message: RemoteMessage?) { message ?: return val data = message.dataOfMap val title = data["title"] ?: return val body = data["body"] ?: return NotificationHelper.show(applicationContext, title, body, data) } } 

Регистрируем в AndroidManifest.xml:

<service android:name=".HmsPushService" android:exported="false"> <intent-filter> <action android:name="com.huawei.push.action.MESSAGING_EVENT" /> </intent-filter> </service> 

Получение токена вручную

// Асинхронно через Task API HmsInstanceId.getInstance(context).getToken(APP_ID, HmsMessaging.DEFAULT_TOKEN_SCOPE) .addOnSuccessListener { token -> ApiClient.registerHmsToken(token, provider = "HMS") } .addOnFailureListener { e -> Log.e("HMS", "Get token failed: ${e.message}") } 

APP_ID — берётся из agconnect-services.json. Токены HMS и FCM — разные, поэтому сервер должен хранить провайдера вместе с токеном.

Серверная отправка через HMS REST API

Endpoint: https://push-api.cloud.huawei.com/v1/{appId}/messages:send. Аутентификация — OAuth2 Bearer token, получается через https://oauth-login.cloud.huawei.com/oauth2/v3/token с client_id и client_secret из AppGallery Connect. Токен живёт 1 час.

{ "message": { "data": "{\"title\":\"Новое сообщение\",\"body\":\"Иван написал вам\"}", "token": ["hms_device_token_here"], "android": { "notification": { "title": "Новое сообщение", "body": "Иван написал вам", "click_action": { "type": 1, "intent": "myapp://message?id=123" } } } } } 

По данным Huawei, Push Kit обеспечивает доставку более 99% сообщений в течение 30 секунд на устройствах с HMS Core.

Сравнение FCM и HMS: что выбрать?

Если ваша аудитория включает СНГ или Китай, HMS — обязательная опция. Runtime detection позволяет обслуживать оба сервиса из одного APK без дублирования кода.

Типичные ошибки при интеграции HMS

Как обрабатывать push-уведомления при свёрнутом приложении?

HMS поддерживает два типа сообщений: display (отображается системой) и data (только данные). Для data-сообщений, которые должны обрабатываться в фоне, установите foreground_show: false в payload. Это позволит вашему HmsMessageService получать сообщения даже после закрытия приложения.

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

Для тестирования нужно физическое Huawei-устройство без GMS или эмулятор из Huawei DevEco Studio. В AppGallery Connect → Push Kit → Test есть встроенный интерфейс для отправки тестовых push на конкретный токен. Рекомендуем также проверить обработку data-сообщений при свёрнутом приложении — это частая причина сбоев.

Что входит в работу

• Регистрация в AppGallery Connect, настройка Push Kit
• agconnect-services.json и HMS SDK подключение
• HmsMessageService с обработкой data-сообщений
• Runtime-детект GMS/HMS и регистрация в нужном сервисе
• Обновление токена на сервере с указанием провайдера
• Серверная отправка через HMS REST API (или интеграция с провайдером типа OneSignal)
• Тестирование на физическом HMS-устройстве

Сроки

Базовая интеграция HMS Push Kit занимает 1 день. С runtime GMS/HMS детектом, полным lifecycle токена и серверной стороной отправки — 2 дня. Точную оценку получите, написав нам — оценим ваш проект бесплатно.

Если вам нужна интеграция Huawei Push Kit с гарантией доставки — свяжитесь с нами для консультации. Мы поможем настроить единую систему push-уведомлений для любого сценария.