Интеграция 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-уведомлений для любого сценария.