Перейти к основному содержимому

Подключение Huawei

Обновлено: 2 сентября 2026

Huawei Mobile Services (HMS) позволяет отправлять push-уведомления на устройства Huawei. При использовании Huawei совместно с Firebase платформа edna может отправлять уведомления через оба облака, что повышает надёжность доставки.

warning
  • Библиотека поддерживает Android 5.0 и выше (minSdkVersion 21).
  • Библиотека подключается к существующему Android-приложению.

Регистрация приложения в Huawei​

Для регистрации приложения выберите подходящий вариант в зависимости от используемой учётной записи:

  • edna — если используется учётная запись edna;
  • Huawei — если используется учётная запись Huawei.
  1. Получите SHA-256 fingerprint сертификата приложения. Пример:

    keytool -list -v -keystore «файл сертификата», Certificate fingerprints.
  2. Передайте специалистам edna appPackage приложения и SHA-256 fingerprint сертификата.

  3. После регистрации приложения получите файл конфигурации agconnect-services.json.

  4. В Android Studio переключитесь в представление Project.

  5. Поместите файл agconnect-services.json в корневую директорию модуля приложения рядом с build.gradle.

warning

Если приложение использует несколько productFlavor, необходимо создать отдельное приложение в AppGallery Connect для каждого варианта сборки. Для каждого productFlavor используется собственный файл agconnect-services.json.

Добавление зависимостей​

Добавьте зависимости в корневой build.gradle и файл app/build.gradle.

Корневой build.gradle​

buildscript {
repositories {
jcenter()
maven {
url 'http://developer.huawei.com/repo/'
}
}
dependencies {
classpath 'com.huawei.agconnect:agcp:1.6.0.300'
}
}

allprojects {
repositories {
jcenter()
maven {
url 'http://developer.huawei.com/repo'
}
}
}

app/build.gradle с использованием BOM Рекомендуемый вариант​

apply plugin: 'com.huawei.agconnect'

android {
compileSdkVersion 36

defaultConfig {
minSdkVersion 21
targetSdkVersion 36
}
}

dependencies {
releaseImplementation platform('com.edna.android:push-lite-bom-release:3.19.0')
releaseImplementation 'com.edna.android:push-lite-huawei-release'

debugImplementation platform('com.edna.android:push-lite-bom-debug:3.19.0')
debugImplementation 'com.edna.android:push-lite-huawei-debug'
}

app/build.gradle без использования BOM​

apply plugin: 'com.huawei.agconnect'

dependencies {
debugImplementation "com.edna.android:push-lite-huawei-debug:3.15.0"
releaseImplementation "com.edna.android:push-lite-huawei-release:3.15.0"
}

Настройка получения статусов доставки (Upstream)​

Использование Upstream позволяет автоматически получать информацию о доставке push-уведомлений средствами Huawei Push Kit и передавать её в edna.

warning

Требования:

  • Android SDK версии 3.1.2 или выше.
  • Push Kit должен быть подключен в AppGallery Connect.
  1. Перейдите в AppGallery Connect и выберите проект.

  2. Откройте раздел Рост → Push Kit → Настройки.

  3. В разделе Получение сообщений от устройств выберите Включить.

  4. В поле Целевой URL-адрес укажите:

    https://pushserver.edna.ru/banks/service/messages/pushUpstreamReceived
  5. Нажмите Отправить для сохранения настроек.

Обработка уведомлений из других источников​

Если приложение получает push-уведомления не только через edna Push Service, но и из других сервисов, можно переопределить обработку следующих событий:

  • обновление Huawei Token;
  • получение входящего уведомления.

Шаг 1. Создайте класс-наследник​

Создайте класс, наследующий com.edna.android.push_lite.HcmPushService, и переопределите методы onNewToken() и onMessageReceived().

import com.edna.android.push_lite.huawei.HcmPushService;
import com.huawei.hms.push.RemoteMessage;

public class PushHcmIntentCustomService extends HcmPushService {

@Override
public void onNewToken(String token) {
// Обработка токена для собственных задач
super.onNewToken(token);
}

@Override
public void onMessageReceived(RemoteMessage message) {
boolean isEdnaPush = true;

if (isEdnaPush && NotificationManagerCompat.from(this).areNotificationsEnabled()) {
super.onMessageReceived(message);
} else {
// Обработка уведомлений из других источников
}
}
}

Шаг 2. Зарегистрируйте сервис​

Добавьте сервис в раздел <application> файла AndroidManifest.xml.

<service
android:name=".push.PushHcmIntentCustomService"
android:exported="false">

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

</service>
warning

Сообщения, отправленные через платформу edna, могут поступать в одном из следующих форматов:

  • JSON;
  • строка (STRING);
  • строка в кодировке Base64.

Для Huawei формат зависит от версии библиотеки:

  • Base64 — для версий ниже 3.10.0;
  • STRING — для версий 3.10.0 и выше.

При реализации обработки рекомендуется поддерживать оба варианта.