Как установить файл .hap на HarmonyOS

Справочник · HarmonyOS · 1 минута чтения

.hap — пакет приложения HarmonyOS (Harmony Ability Package). Обычные пользователи его не ставят: приложения для HarmonyOS 5.0 и новее приходят из AppGallery, и магазин сам загружает нужные пакеты. Вручную .hap ставят разработчики — на свои устройства, для проверки программы.

Что нужно

устройство с HarmonyOS 5.0 и новее с включённым режимом разработчика и отладкой — справка Как включить режим разработчика;
компьютер с DevEco Studio — в ней есть и инструмент hdc;
подписанный пакет: без подписи приложение не установится. Подпись настраивается в DevEco Studio: File → Project Structure → Project → Signing Configs.

Установка

Из DevEco Studio: выберите устройство и нажмите Run — среда соберёт, подпишет и установит пакет сама.

Командой hdc из папки SDK DevEco Studio:

Терминал

$ hdc list targets
$ hdc install entry-default-signed.hap
$ hdc install -r entry-default-signed.hap

Первая команда показывает подключённые устройства, вторая ставит пакет, третья — переустанавливает поверх уже установленного. Удалить приложение — hdc uninstall и имя пакета, например com.example.myapplication.

Почему не ставится

Пакет не подписан или подписан для другого устройства — подпишите заново в DevEco Studio.
Не включена отладка — hdc list targets не показывает устройство.
Система старше, чем требует пакет: в проекте указана минимальная версия (Compatible SDK).
Устройство с HarmonyOS 4.x или EMUI — пакеты для 5.0 и новее на нём не ставятся.

Не ставьте .hap из интернета от неизвестных людей. Включённая отладка и чужой пакет дают постороннему коду доступ к устройству; после работы выключайте режим разработчика.

Подробнее о разработке — урок Для разработчиков.