Путь к разработке под экосистему Huawei начинается с регистрации в AppGallery Connect и изучения возможностей HMS Core. В отличие от классического Android, здесь нет Google Play Services, поэтому работа строится вокруг набора проприетарных API и сервисов Huawei Mobile Services. Первым действием разработчика становится создание учетной записи и прохождение процедуры верификации личности или компании.
После подтверждения аккаунта открывается доступ к консоли управления приложениями, аналитике и монетизации. AppGallery Connect объединяет инструменты для всего жизненного цикла продукта: от интеграции SDK до настройки внутренних покупок и push-уведомлений. Без этого этапа невозможно тестировать приложения на реальных устройствах или публиковать их в официальном магазине.
Регистрация и верификация аккаунта разработчика
Процедура входа в программу Huawei Developer Program требует соблюдения строгих правил идентификации. Для физических лиц достаточно паспорта, а юридическим лицам — уставных документов и доверенности на представителя. Верификация занимает от нескольких часов до 3 рабочих дней в зависимости от нагрузки на модерацию.
Важно заранее подготовить сканы документов в формате JPG или PNG с читаемыми реквизитами. Система автоматически проверяет соответствие данных профиля представленным документам. Любое несоответствие в названии компании или ФИО приведет к отклонению заявки и потере времени.
☑️ Чек-лист документов для верификации
⚠️ Внимание: Использование виртуальных номеров или временных почтовых ящиков при регистрации приводит к автоматической блокировке аккаунта без возможности восстановления. Указывайте только постоянные контакты.
После успешной верификации назначьте роли участникам команды в разделе Users and Permissions. Разделение прав доступа (Admin, Developer, Finance, Tester) критично для безопасности: финансовые отчеты и настройки платежей должны быть доступны только доверенным лицам.
Основные платформы: HMS Core и HarmonyOS
HMS Core — это фундамент для приложений на устройствах с EMUI и HarmonyOS. Набор включает более 50 кросс-платформенных кеней (Kits): от Push Kit и In-App Purchases до ML Kit для машинного обучения и Map Kit для навигации. Интеграция происходит через Maven-репозиторий Huawei или ручное добавление .aar библиотек.
HarmonyOS вводит концепцию «супер-устройства» и распределенную архитектуру. Разработка под эту ОС ведется на языках ArkTS (рекомендуемый), Java и JS/TS. Ключевое отличие — модель Ability вместо привычных Activity и использование декларативного UI-фреймворка ArkUI.
Для кроссплатформенных проектов доступны плагины для Flutter, React Native, Unity и Cocos. Они оборачивают нативные HMS API в единый интерфейс, позволяя поддерживать единую кодовую базу для Google Play и AppGallery. Однако нативная реализация на ArkTS дает максимальную производительность и доступ к уникальным фичам HarmonyOS.
⚠️ Внимание: При миграции приложения с GMS на HMS не удаляйте зависимости Firebase/Core до полной проверки работоспособности HMS-аналогов. Параллельный запуск обоих стек позволяет откатиться за минуты при критических багах.
Сравнение ключевых сервисов GMS и HMS
Push Notifications → Push Kit | Maps → Map Kit | Location → Location Kit | Ads → Ads Kit | Auth → Account Kit | Drive → Drive Kit | ML Kit → ML Kit (совпадает по названию, другой API) | SafetyNet → Safety Detect
Инструментарий: DevEco Studio и эмуляторы
Официальная IDE — DevEco Studio, основанная на IntelliJ IDEA. Она включает встроенный эмулятор для HarmonyOS, визуальный редактор ArkUI (Previewer), профайлер производительности и анализатор кода. Скачать актуальную версию можно только с developer.huawei.com — сторонние зеркала могут содержать устаревшие SDK.
Настройка среды требует установки Node.js (для ArkTS), JDK 1.8+ и Ohpm (менеджер пакетов HarmonyOS). В настройках File | Settings | Appearance & Behavior | System Settings | HTTP Proxy часто приходится прописывать корпоративный прокси, иначе загрузка SDK зависает на 0%.
Используйте Remote Device (удаленное тестирование) в DevEco Studio — это быстрее локального эмулятора и дает доступ к реальному железу новых флагманов без покупки.
Для отладки на физических устройствах включите USB Debugging в меню Settings | Developer options и авторизуйте ПК по RSA-ключу. На ноутбуках MateBook с предустановленным PC Manager происходит автоматическое сопряжение и установка HiSuite, что упрощает передачу логов и APK-файлов.
| Компонент | Назначение | Поддерживаемые ОС хоста |
|---|---|---|
| DevEco Studio | IDE, эмулятор, превью UI, профайлер | Windows, macOS, Linux |
| HMS Toolkit | Плагин для VS Code / IntelliJ для HMS Core | Windows, macOS, Linux |
| AppGallery Connect CLI | Автоматизация сборки и публикации (CI/CD) | Кроссплатформенно |
| Ohpm | Менеджер пакетов для HarmonyOS модулей | Windows, macOS, Linux |
| HDC (HarmonyOS Device Connector) | ADB-аналог для управления устройствами | Windows, macOS, Linux |
Публикация в AppGallery: модерация и согласование
Загрузка сборки (.apk, .aab или .hap) выполняется во вкладке My Apps | New App. Система требует заполнения карточки: иконка 512x512 px, скриншоты для телефона, планшета и часов, политика приватности (обязательно ссылка на https://), возрастной рейтинг по системе GRAC или IARC.
Автоматическая проверка AppGallery Connect сканирует бинарник на наличие вредоносного кода, недокументированных API и нарушений политики контента. Ручная модерация команды Huawei проверяет соответствие UI-гайдлайнам HarmonyOS Design, корректность работы на девайсах без GMS и отсутствие скрытых платежей.
Среднее время модерации: 1-2 рабочих дня для обновлений, до 5 дней для новых приложений. Отказы чаще всего связаны с неработающими покупками или нарушением гайдлайнов UI.
При отклонении приходит подробный отчет с логами ошибок и скриншотами проблемных экранов. Исправленную версию загружают в ту же карточку — номер версии (versionCode) должен быть строго больше предыдущего. После одобрения приложение появляется в магазине в течение нескольких часов.
Монетизация: IAP, Ads Kit и подписки
In-App Purchases (IAP) в AppGallery поддерживают расходуемые, нерасходуемые товары и автопродлеваемые подписки. Комиссия Huawei составляет 15-30% в зависимости от категории и объема выручки (для образовательных и социальных проектов возможны сниженные ставки по запросу). Выплаты производятся ежемесячно на корпоративный счет с задержкой 45-60 дней после закрытия отчетного периода.
Ads Kit предлагает нативные, интерстишиал, ревард-видео и баннерные форматы. Заполнение (fill rate) в СНГ и Европе выше, чем у глобальных сетей, за счет прямой интеграции с системой рекомендаций Huawei. Минимальный порог вывода — $100, способы: банковский перевод, PayPal (в доступных регионах).
⚠️ Внимание: Тестирование платежей возможно только на устройстве с авторизованным тестовым аккаунтом, добавленным в консоли AppGallery Connect | Test Users. Реальные карты в тестовом режиме списывать не будут, но заказ создастся.
Для продвижения используйте AppGallery Connect | Growth: предрегистрация, A/B тестирование иконок, глубокие ссылки (App Links) и программу «Рекомендуемые» (Editor's Choice). Попадание в подборку дает органический трафик, сравнимый с фичингом в Google Play.
Сертификация, обучение и сообщество
Официальная программа Huawei Developer Certification включает уровни: Associate (базовый), Professional (продвинутый) и Expert (эксперт). Экзамены сдаются онлайн на платформе Pearson VUE или в авторизованных центрах. Сертификат подтверждает навыки работы с HMS Core, HarmonyOS App Development и Cloud Services.
Бесплатные курсы и лабораторные работы доступны в Huawei Developer Academy (раздел Training на сайте разработчика). Материалы обновляются синхронно с выходом новых версий SDK. Рекомендую начать с трека HarmonyOS Application Developer — он охватывает ArkTS, ArkUI, распределенные способности и публикацию.
Полезные ресурсы для ежедневной работы
Документация: developer.huawei.com/doc | Примеры кода: github.com/hmscore | Форум: forum.huawei.com (раздел Developer) | Статус сервисов: developer.huawei.com/consumer/en/doc/start/Service-Status | Telegram-сообщества: @huawei_dev_ru, @harmonyos_ru
Активное участие в Huawei Developer Groups (HDG) и хакатонах (например, Apps UP) дает доступ к ранним бета-версиям SDK, мерчу и прямую связь с инженерами Huawei. Победители конкурсов получают маркетинговую поддержку иfeaturing в AppGallery.
Подпишитесь на рассылку «Developer Newsletter» в профиле AppGallery Connect — приходят критические уведомления об устаревших API и дедлайнах миграции за 3-6 месяцев.
Частые ошибки новичков и как их избежать
Самая распространенная проблема — игнорирование agconnect-services.json. Этот конфигурационный файл генерируется в консоли для каждого пакета приложения и содержит client_id, api_key и настройки сервисов. Его отсутствие или несовпадение package name вызывает ошибку 6003: Invalid parameter при инициализации любого HMS Kit.
Вторая ловушка — использование устаревших артефактов Maven. Репозиторий developer.huawei.com/repo/ регулярно обновляется, старые версии библиотек удаляются. Всегда указывайте в build.gradle конкретные версии (например, 6.11.0.300), а не +, и проверяйте доступность перед релизом.
Третий кейс — тестирование только на эмуляторе. На реальных устройствах HarmonyOS NEXT (без AOSP-слоя) отсутствуют системные WebView и Java-рантайм. Приложения на чистом ArkTS работают нативно, но гибридные решения (WebView, JNI) требуют полной переработки. Проверяйте сборку на физическом девайсе с актуальной прошивкой.
FAQ: Частые вопросы о разработке для Huawei
Нужен ли отдельный аккаунт для публикации в AppGallery и для HMS Core?
Нет, единый Huawei ID с пройденной верификацией дает доступ ко всем сервисам: AppGallery Connect, HMS Core, Cloud, Ads, Developer Academy.
Можно ли публиковать приложение только в AppGallery, не выпуская в Google Play?
Да, многие разработчики выбирают монопольное присутствие в экосистеме Huawei. Это упрощает поддержку (один стек HMS) и дает доступ к аудитории 700+ млн активных устройств.
Как мигрировать пуш-уведомления с Firebase (FCM) на Push Kit?
Интегрируйте Push Kit SDK, замените токены регистрации на сервере и настройте пересылку сообщений через консоль AppGallery Connect. Для плавного перехода используйте токен-маппинг: храните пары FCM token / HMS token в базе пользователей.
Работает ли Google Maps внутри приложения на HarmonyOS NEXT?
Нет, на HarmonyOS NEXT нет GMS. Необходимо мигрировать на Map Kit (векторные карты, навигация, поиск мест) или использовать WebView с Яндекс.Картами / 2GIS, если лицензия позволяет.
Где найти актуальные гайды по настройке устройств для тестирования?
В справочнике https://huawei-gid.vercel.app собраны инструкции по включению режима разработчика, установке APK/HAP и работе с логами на разных моделях.