harmonyos-build-deploy

Automate HarmonyOS build, packaging, and deployment with hvigorw and hdc.

Updated Jul 6, 2026
One-click install
npx skills add https://github.com/shirulot/codex-skill --skill harmonyos-build-deploy
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: harmonyos-build-deploy
Source: https://github.com/shirulot/codex-skill/tree/main/harmonyos-build-deploy
Command: npx skills add https://github.com/shirulot/codex-skill --skill harmonyos-build-deploy

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill automates the complex, multi-step lifecycle of HarmonyOS development, including cleaning build artifacts, managing dependencies, packaging bundles, and deploying them to physical devices.

Core Features & Use Cases

  • Full Pipeline Automation: Executes clean, install, build, and deploy sequences in one go.
  • Device Management: Simplifies hdc interactions for installing, launching, and debugging applications on HarmonyOS devices.
  • Use Case: When iterating on a new feature, use this skill to quickly rebuild only the modified module and push the updated HAP to your connected test device without manual CLI configuration.

Quick Start

Use the harmonyos-build-deploy skill to perform a full clean build and install the application to the connected device.

Frequently Asked Questions about harmonyos-build-deploy

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate HarmonyOS app build and deployment to a physical device?

Automate HarmonyOS build and deployment by executing clean, install, build, and deploy sequences in one go using hvigorw and hdc. This pipeline automatically manages dependencies via ohpm and pushes the HAP bundle to your connected device.

What is the best way to rebuild only a modified HarmonyOS module and install it?

The best way to rebuild a modified HarmonyOS module is using module-specific build automation. This triggers hvigorw to compile only the updated module and uses hdc to push the updated HAP directly to your connected test device without manual CLI configuration.

Does hdc support installing and launching HarmonyOS applications via the Bundle Manager?

Yes, hdc supports installing and launching HarmonyOS applications via the Bundle Manager. The automation script simplifies hdc interactions for device-side installation, debugging, and application startup directly on connected hardware.

How are ohpm dependencies managed during an end-to-end HarmonyOS build process?

During an end-to-end HarmonyOS build process, ohpm dependencies are managed automatically within the pipeline. The automation handles dependency resolution before packaging bundles with hvigorw, ensuring the environment configuration remains consistent.

Why does my HarmonyOS build or installation fail and how can I handle the errors?

Your HarmonyOS build or installation may fail due to environment inconsistencies or device connection issues. The automation provides built-in error handling for common build and installation failures to identify and resolve these issues without manual debugging.

Do I need to manually configure the CLI environment for hvigorw and hdc deployment?

No, manual CLI configuration is not required for hvigorw and hdc deployment. The automation ensures consistent environment configuration across the build, package, and deploy lifecycle, allowing you to push updates directly to physical devices.