При попытке авторизоваться в AppGallery Connect или скачать DevEco Studio с неофициального зеркала разработчики часто получают ошибку проверки сертификата или устаревшую версию инструментов. Официальный портал для разработчиков Huawei находится по адресу https://developer.huawei.com, и именно с него нужно начинать работу с экосистемой HarmonyOS и HMS Core. Ниже разобраны все ключевые разделы портала, прямые ссылки на загрузку и типичные ошибки авторизации.
Портал полностью локализован на русский язык, но часть технической документации по-прежнему доступна только на английском или китайском. Для работы с эмулятором и подписи APK вам потребуется аккаунт Huawei ID, причём регистрация с российского номера телефона проходит без дополнительных ограничений.
Регистрация аккаунта разработчика Huawei
Начните с создания аккаунта на странице https://developer.huawei.com/consumer/cn/ — это единая точка входа для всех сервисов. Вам нужно нажать кнопку «Регистрация» в правом верхнем углу и указать актуальный email. После подтверждения почты профиль автоматически получает статус разработчика без платной верификации, в отличие от Google Play.
Сразу после регистрации откройте AppGallery Connect по адресу https://developer.huawei.com/consumer/cn/service/josp/agc/index.html — здесь создаются проекты приложений и подключаются модули HMS Core. Обратите внимание: консоль разработчика и сам портал — это разные интерфейсы, и для входа в оба используется один и тот же Huawei ID.
⚠️ Внимание: не используйте аккаунт, который уже привязан к китайскому AppGallery. Международный и китайский сегменты портала имеют разные базы данных, и приложения из одного региона не видны в другом.
Где скачать DevEco Studio и необходимые SDK
Главный инструмент для разработки под HarmonyOS — это DevEco Studio, основанный на IntelliJ IDEA. Скачать его можно только с официальной страницы загрузки: https://developer.huawei.com/consumer/cn/deveco-studio/. Версии для Windows, macOS и Linux доступны без регистрации, но для активации лицензии потребуется вход в аккаунт.
После установки IDE вам понадобятся пакеты HarmonyOS SDK и HMS Core SDK. Они загружаются прямо из интерфейса DevEco Studio через меню Tools → SDK Manager. Не пытайтесь скачивать SDK вручную через браузер — репозиторий закрыт, а все прямые ссылки привязаны к вашей учётной записи.
Путь для импорта SDK в DevEco Studio:
File → Project Structure → SDK Location → указать папку HarmonyOS SDK
- 🛠️ DevEco Studio — основная IDE, включающая эмулятор устройств и профилировщик
- 📦 HarmonyOS SDK — набор библиотек для нативных приложений под OpenHarmony
- 🔌 HMS Core SDK — модули для карт, пушей, платежей и ML-сервисов
- 🧪 Device Simulator — облачный эмулятор для тестирования на реальных моделях
Официальная документация и примеры кода
Техническая документация по HMS Core расположена в разделе https://developer.huawei.com/consumer/cn/doc/. Здесь собраны руководства по интеграции всех модулей: от базового Account Kit до сложных ML Kit и Location Kit. Для каждой библиотеки есть примеры кода на Java, Kotlin и C++.
Отдельного внимания заслуживает HarmonyOS Developer Documentation — она описывает архитектуру приложений для операционной системы нового поколения. В отличие от Android, здесь используется собственный язык ArkTS и компонентная модель Ability. Переход на HarmonyOS требует переписывания UI-слоя, но бизнес-логику можно перенести почти без изменений.
Как получить доступ к бета-версиям документации
Для доступа к предрелизным материалам HarmonyOS NEXT перейдите в раздел «Бета-программы» на портале разработчика. Заявки рассматриваются в течение 3-5 рабочих дней, после чего в личном кабинете появится вкладка с закрытой документацией. Учитывайте, что NDA-соглашение запрещает публикацию скриншотов и фрагментов кода из бета-разделов.
AppGallery Connect: публикация и аналитика
Консоль AppGallery Connect — это аналог Google Play Console. Через неё вы загружаете APK/AAB файлы, настраиваете бета-тестирование и отслеживаете краш-репорты. Вход в консоль выполняется по адресу https://developer.huawei.com/consumer/cn/service/josp/agc/index.html с тем же аккаунтом разработчика.
Ключевое отличие от Google Play — отсутствие обязательной таксономии категорий и более гибкая система ревью. Модерация приложения обычно занимает от 2 до 24 часов, а для обновлений часто применяется автоматическая проверка. Однако для доступа к платежам и рекламным сервисам требуется отдельная верификация компании.
| Сервис | URL | Назначение |
|---|---|---|
| AppGallery Connect | developer.huawei.com/consumer/cn/service/josp/agc/index.html | Публикация приложений, аналитика, монетизация |
| DevEco Studio | developer.huawei.com/consumer/cn/deveco-studio/ | IDE для разработки под HarmonyOS и Android |
| HMS Core SDK | developer.huawei.com/consumer/cn/doc/hms-core-V5/ | Библиотеки для интеграции сервисов Huawei |
| Форум разработчиков | developer.huawei.com/consumer/cn/forum/ | Обсуждение проблем, вопросы по SDK |
Ключевой вывод: Единая точка входа для всех инструментов разработчика Huawei — портал developer.huawei.com. Все SDK и IDE скачиваются только через официальные каналы, а для входа в консоль используется один аккаунт Huawei ID.
Эмулятор и тестирование на реальных устройствах
Встроенный в DevEco Studio эмулятор поддерживает последние модели флагманов, включая Huawei P60 Pro и Mate 60. Запуск эмулятора требует не менее 8 ГБ оперативной памяти и включённой виртуализации в BIOS. Для устройств на базе Kirin 9000 эмуляция работает медленнее, чем на реальном железе, поэтому для финального тестирования рекомендуется использовать физическое устройство.
Подключение реального смартфона выполняется через USB-отладку в режиме разработчика. На устройстве нужно активировать пункт «Версия ядра» семь раз в настройках, после чего включить «Отладку по USB». В DevEco Studio выберите устройство в выпадающем списке и нажмите Run — приложение установится автоматически.
⚠️ Внимание: на устройствах с HarmonyOS NEXT (без Android-подсистемы) отладка происходит по беспроводному каналу через Wi-Fi. Убедитесь, что смартфон и компьютер находятся в одной локальной сети, а в настройках разработчика включён пункт «Беспроводная отладка».
☑️ Чек-лист для первого запуска DevEco Studio
Типичные ошибки авторизации и их решение
Чаще всего разработчики сталкиваются с ошибкой 403 Forbidden при попытке скачать SDK или открыть документацию. Причина — региональные ограничения: часть серверов Huawei блокирует запросы с IP-адресов некоторых стран. Проверьте, не используете ли вы VPN с китайским сервером — международный сегмент портала не работает через китайские прокси.
Вторая по частоте проблема — ошибка Invalid Huawei ID при входе в AppGallery Connect. Это происходит, если аккаунт был создан на китайском портале, но вы пытаетесь войти в международную версию. Решение — зарегистрировать новый аккаунт или переключить регион в настройках профиля, но учтите, что смена региона доступна только раз в 30 дней.
Если после входа вы видите пустую консоль без возможности создать проект, проверьте, что в профиле указана страна проживания, а не корпоративный адрес. Для физических лиц из России и СНГ доступны все сервисы, кроме платежей через операторов связи.
Альтернативные источники: форумы и GitHub
Официальный форум разработчиков находится по адресу https://developer.huawei.com/consumer/cn/forum/, но там отвечают не всегда быстро. Более оперативные ответы можно получить в англоязычном разделе Stack Overflow по тегу huawei-mobile-services. Также существует официальный GitHub-аккаунт Huawei с примерами кода: https://github.com/HMS-Core.
Для русскоязычного сообщества стоит обратить внимание на Telegram-каналы и чаты, посвящённые HMS Core. Однако помните: любые примеры кода из сторонних источников нужно проверять на совместимость с вашей версией SDK. Версии HMS Core 6.x значительно отличаются от 5.x по структуре вызовов, и слепое копирование старого кода приведёт к ошибкам компиляции.
Полезный совет: Перед написанием кода проверьте версию HMS Core в файле build.gradle. Актуальные версии всегда перечислены в официальном репозитории Maven: maven { url 'https://developer.huawei.com/repo/' }. Добавьте этот репозиторий в корневой build.gradle проекта, чтобы избежать конфликтов зависимостей.
FAQ: частые вопросы разработчиков Huawei
Можно ли использовать Android Studio вместо DevEco Studio для разработки под Huawei?
Да, для разработки под Android-совместимые устройства Huawei (с EMUI) можно использовать стандартную Android Studio. Но для HarmonyOS NEXT и HMS Core потребуется DevEco Studio, так как Android Studio не поддерживает ArkTS и Ability-модель.
Как получить доступ к бета-версии HarmonyOS для разработки?
Для этого нужно подать заявку в программу бета-тестирования на портале разработчика. Обычно доступ открывается за 2-3 месяца до официального релиза. В заявке укажите модели устройств, на которых планируете тестировать.
Нужно ли платить за публикацию приложения в AppGallery?
Нет, регистрация аккаунта разработчика и публикация приложений полностью бесплатны. Однако для использования платёжных сервисов и рекламных модулей может потребоваться верификация юридического лица.
Как перенести приложение с Google Play на AppGallery?
В большинстве случаев достаточно пересобрать APK без изменений кода, так как AppGallery поддерживает стандартные Android-приложения. Для использования HMS Core вместо GMS потребуется заменить вызовы Google Play Services на аналогичные модули HMS.
Работа с экосистемой Huawei требует привыкания к другому набору инструментов, но портал разработчика покрывает все потребности: от скачивания IDE до публикации и аналитики. Начните с регистрации аккаунта на developer.huawei.com, установите DevEco Studio и создайте тестовый проект — остальные шаги станут очевидными после первого запуска.