Переход на разработку под экосистему Huawei начинается с понимания ключевого отличия: на устройствах без GMS работают только приложения, интегрированные с HMS Core. Это означает, что стандартные вызовы Firebase, Google Maps или Play Billing не сработают и требуют замены на аналогичные киты Huawei. Первым действием становится создание аккаунта разработчика в консоли AppGallery Connect, так как без верифицированного профиля невозможно получить доступ к API и опубликовать приложение.
Экосистема Huawei предлагает полный стек инструментов: от IDE и эмуляторов до сервисов аналитики, пуш-уведомлений и внутренних покупок. Разработчику придется освоить не только новые SDK, но и процесс модерации, который строже проверяет соответствие политикам конфиденциальности и использование разрешенных API. Успешный вход в этот рынок открывает доступ к аудитории более 700 миллионов активных устройств по всему миру.
Регистрация и верификация в AppGallery Connect
Процесс регистрации отличается для физических лиц и организаций. Для компании требуется предоставление документа о регистрации (свидетельство ОГРН/ИНН для РФ), письма уполномоченного представителя и скана паспорта директора. Верификация занимает от одного до трех рабочих дней; без статуса «Verified» нельзя публиковать приложения или использовать платежные киты.
После одобрения аккаунта необходимо настроить профиль продавца: указать банковские реквизиты для выплат, заполнить налоговые формы (W-8BEN для нерезидентов США) и привязать аккаунт к Huawei ID. Ошибки в реквизитах задерживают выплаты на неопределенный срок, поэтому проверяйте IBAN и SWIFT коды дважды. В консоли сразу создайте проект приложения, чтобы получить файл agconnect-services.json — он нужен для инициализации SDK на клиенте.
- 📋 Подготовьте уставные документы и доверенность заранее
- 🔐 Используйте корпоративный Huawei ID, а не личный
- 💳 Заполните налоговый профиль до первой публикации
- 📧 Укажите рабочую почту для уведомлений модерации
⚠️ Внимание: Смена типа аккаунта с «Индивидуальный» на «Организация» после верификации невозможна — придется создавать новый профиль и переносить приложения вручную через поддержку.
Изучение HMS Core и ключевых китов
HMS Core — это набор библиотек, заменяющих Google Mobile Services. Основные киты: Push Kit (пуши), Location Kit (геолокация), Map Kit (карты), In-App Purchases (покупки), Account Kit (авторизация через Huawei ID), Analytics Kit (аналитика) и Ads Kit (монетизация). Каждый кит имеет свою версию и зависимость от com.huawei.hms:base.
На практике миграция выглядит так: вы удаляете google-services.json, добавляете agconnect-services.json и по очереди заменяете импорты com.google. на com.huawei.hms.. Например, вместо FirebaseMessaging используете HmsMessaging, а вместо FusedLocationProviderClient — FusedLocationProviderClient из Location Kit. API во многих случаях зеркальны, но есть нюансы в колбэках и кодов ошибок.
| Google Service (GMS) | Huawei Alternative (HMS) | Сложность миграции |
|---|---|---|
| Firebase Cloud Messaging | Push Kit | Низкая (API похожи) |
| Google Maps SDK | Map Kit | Средняя (другие маркеры/слои) |
| Play Billing Library | IAP Kit | Высокая (разная логика подписок) |
| Firebase Auth | Account Kit + Auth Service | Низкая (OAuth 2.0 стандарт) |
| Google Sign-In | Huawei ID Sign-In | Низкая |
Настройка среды разработки: Android Studio и инструменты Huawei
Рекомендуется использовать последнюю версию Android Studio (Koala или новее) с установленным плагином AppGallery Connect Plugin. Он добавляет меню Tools > AppGallery Connect для генерации конфигов, проверки подписи и загрузки билдов прямо из IDE. Также установите HMS Toolkit — он включает эмуляторы устройств Huawei, инспектор кода для поиска GMS-зависимостей и конвертер проектов.
Для тестирования на ПК без физического устройства скачайте Cloud Debugging — удаленные реальные телефоны в дата-центрах Huawei. Доступ предоставляется бесплатно разработчикам с верифицированным аккаунтом. В build.gradle добавьте репозиторий maven { url 'https://developer.huawei.com/repo/' } и плагин com.huawei.agconnect версии 1.7.+ для корректной сборки.
☑️ Минимальный чек-лист среды разработки
⚠️ Внимание: Не используйте старые версии плагинаagconnectниже 1.6.0 — они несовместимы с последними SDK китов и вызывают ошибкуClassNotFoundExceptionпри сборке Release-билда.
Используйте анализатор кода в HMS Toolkit (Code Checker): он автоматически находит вызовы GMS API и предлагает готовые замены HMS с ссылками на документацию. Это экономит часы ручного поиска.
Адаптация существующего Android-приложения под HMS
Стратегия «Dual Build» позволяет поддерживать одну кодовую базу для Google Play и AppGallery. Используйте flavorDimensions "store" с флейворами gms и hms. В sourceSets вынесите инициализацию сервисов в отдельные классы: GmsInitializer и HmsInitializer, а в манифесте через manifestPlaceholders подставляйте нужные провайдеры и разрешения.
Критические места: работа с файлами (Scoped Storage работает одинаково), камера (CameraX поддерживает оба), биометрия (BiometricPrompt универсален). Проблемы вызывают фоновые сервисы: на EMUI/HarmonyOS агрессивное управление питанием убивает процессы. Необходимо запросить у пользователя разрешение «Автозапуск» через PowerGenie или направить в настройки «Защита батареи → Ручное управление».
Пример конфигурации flavorDimensions в build.gradle
android {
flavorDimensions "store"
productFlavors {
gms {
dimension "store"
applicationIdSuffix ".gms"
manifestPlaceholders = [pushProvider: "com.google.firebase.messaging.FirebaseMessagingService"]
}
hms {
dimension "store"
applicationIdSuffix ".hms"
manifestPlaceholders = [pushProvider: "com.huawei.hms.push.HmsMessagingService"]
}
}
}
Публикация и модерация в AppGallery
Загрузка сборки происходит через консоль или плагин. Обязательны: иконка 512x512 px, скриншоты для телефона, планшета и часов (минимум 3 на форму-фактор), политика конфиденциальности на хостинге с HTTPS. Модерация проверяет: соответствие возрастному рейтингу, отсутствие скрытого функционала, корректность работы HMS китов, соблюдение законов о данных (152-ФЗ для РФ, GDPR для ЕС).
Среднее время ревью — 1-2 рабочих дня. При отклонении приходит подробный отчет с кодом причины (например, POL-003 — нарушение политики конфиденциальности). Исправленную версию загружают как новый билд с повышенным versionCode. После одобрения приложение появляется в магазине в течение нескольких часов. Обновления проходят ускоренную модерацию, если не меняются разрешения и нативный код.
- 🛡️ Добавьте
network_security_config.xmlдля HTTPS only - 📄 Разместите Privacy Policy на отдельном домене
- 🌐 Локализуйте описание на китайский для основного рынка
- 🧪 Протестируйте на Cloud Debugging перед отправкой
⚠️ Внимание: AppGallery блокирует публикацию, если в манифесте найдены разрешенияREAD_PHONE_STATEилиGET_ACCOUNTSбез обоснования в форме модерации. Удаляйте неиспользуемые пермишены заранее.
Главный вывод: стратегия Dual Build с flavorDimensions позволяет поддерживать GMS и HMS версию в одном проекте, минимизируя дублирование кода и ошибки сборки.
Перспективы: HarmonyOS NEXT и нативная разработка
С выходом HarmonyOS NEXT (без AOSP-слоя) запуск APK-файлов станет невозможным. Новый формат — HAP (HarmonyOS Ability Package), язык — ArkTS (расширенный TypeScript), фреймворк — ArkUI (декларативный UI). Huawei предоставляет инструмент Porting Assistant для автоматического конвертирования Java/Kotlin + XML в ArkTS + ArkUI, но ручная доработка неизбежна.
Уже сейчас можно начать изучать DevEco Studio — официальную IDE для HarmonyOS. Она включает превью-инспектор, эмулятор NEXT и профилировщик производительности. Нативные приложения получают приоритет в поиске AppGallery, доступ к системным API (распределенные возможности, супер-устройство) и более высокий рейтинг доверия пользователей. Инвестиции в обучение сейчас дадут конкурентное преимущество к массовому переходу 2026-2026 годов.
Монетизация и продвижение в экосистеме
AppGallery берет комиссию 15% на первый миллион долларов выручки в год и 30% далее — аналогично Google Play. Поддерживаются: разовые покупки, подписки (с льготным периодом и бесплатной пробой), консумируемые товары. Выплаты производятся ежемесячно с задержкой 45 дней, минимальный порог — 100 USD. Для РФ доступны выплаты на расчетный счет в рублях по курсу ЦБ на день платежа.
Продвижение: AppGallery Boost (CPI-кампании), Search Ads (ставки по ключевым словам), участие в рубриках «Рекомендуем» и «Игры недели». Для попадания в фичи нужен рейтинг 4.5+, высокий Retention Day 1/7 и использование свежих HMS фич (например, виджеты на рабочем столе или быстрые приложения Quick Apps). Аналитика в консоли показывает воронку: просмотры страницы → установки → покупки → LTV.
Подключите crashlytics аналог — Crash Service из AG Connect. Он бесплатен, не требует отдельного SDK (входит в base) и показывает стеки с обфускацией через mapping-файлы, загружаемые автоматически при сборке через плагин.
Частые ошибки новичков и как их избежать
Самая частая ошибка — игнорирование деградации функционала на устройствах со старыми версиями HMS Core (апдейт сервисов идет через AppGallery, а не системный OTA). Всегда проверяйте версию клиента через HmsCore.getVersion() и показывайте диалог обновления, если версия ниже минимальной для используемого кита. Вторая ошибка — хардкод строковых ресурсов для карт и платежей; используйте res/values-zh/strings.xml для китайского рынка.
Третья проблема — тестирование только на эмуляторе. Поведение управления питанием, уведомлениями и биометрией на реальных устройствах Mate, P-series и Nova кардинально отличается. Обязательно арендуйте 2-3 модели в Cloud Debugging перед релизом. Четвертая — забывают про proguard-rules.pro для HMS классов, что ломает пуши и покупки в Release-сборке.
- 🔄 Проверяйте версию HMS Core в runtime
- 🌍 Добавляйте локализацию zh-CN и zh-TW
- ☁️ Тестируйте на Cloud Debugging минимум на 3 моделях
- 🛡️ Добавляйте
-keep class com.huawei.hms.** { *; }в ProGuard
FAQ: Частые вопросы о разработке под Huawei
Нужен ли отдельный ПК под macOS/Linux для разработки под HarmonyOS NEXT?
Нет, DevEco Studio доступен для Windows, macOS (Intel и Apple Silicon) и Linux. Эмулятор HarmonyOS NEXT работает на всех платформах с поддержкой виртуализации (Hyper-V, KVM, Apple Hypervisor).
Можно ли публиковать одно приложение сразу в Google Play и AppGallery?
Да, используя стратегию Dual Build с productFlavors. Это стандартная практика: один код, две сборки с разными зависимостями и манифестами. Пакетные имена обычно отличаются суффиксами .gms и .hms.
Как тестировать In-App Purchases без реальных денег?
В консоли AppGallery Connect создайте тестовые аккаунты (Test Users) в разделе «Тестирование покупок». На устройстве выйдите из основного Huawei ID и войдите тестовым — покупки будут проходить в sandbox-режиме без списаний.
Обязательно ли мигрировать на ArkTS прямо сейчас?
Пока нет. APK-приложения будут работать на HarmonyOS 4.x и ниже еще несколько лет. Но новые флагманы 2026-2026 на HarmonyOS NEXT не смогут их запустить. Начинать изучение ArkTS и DevEco Studio сейчас — стратегически верное решение.
Где найти актуальную документацию и примеры кода?
Официальный портал: developer.huawei.com/consumer/ru/. Там же — CodeLab пошаговые туториалы, демо-проекты на GitHub (организация HMS-Core) и форум разработчиков с поддержкой инженеров Huawei. Также полезные материалы есть на нашем сайте huawei-gid.vercel.app.