ohos-one-stop-build

Build, install, launch, and collect logs for HarmonyOS apps in one command.

Updated Mar 16, 2026
One-click install
npx skills add https://github.com/zhouxiumin/zxm-skills --skill ohos-one-stop-build
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ohos-one-stop-build
Source: https://github.com/zhouxiumin/zxm-skills/tree/main/skills/ohos-one-stop-build
Command: npx skills add https://github.com/zhouxiumin/zxm-skills --skill ohos-one-stop-build

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

HarmonyOS development often requires separate steps for building, installing, running, and retrieving logs. This skill consolidates those actions into a single command workflow to reduce manual overhead and context-switching.

Core Features & Use Cases

  • One-command workflow: Build → Install → Run → Fetch Logs for OHOS apps.
  • Auto-detection: Locates hvigorw/hdc and configures JAVA_HOME when needed.
  • Flexible configuration: Supports custom PROJECT_ROOT, MODULE, PRODUCT, BUNDLE, and log settings. Use cases include rapid iterative development, debugging CI pipelines, and device log analysis.

Quick Start

Run the core workflow to build, install, start, and fetch logs for your OHOS project.

Frequently Asked Questions about ohos-one-stop-build

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

FAQPage Schema
How do I automate the HarmonyOS build, install, and run workflow in one command?

HarmonyOS build, install, and run workflow can be automated using a one-stop command that executes these steps sequentially and fetches logs to reduce manual overhead.

What is the best way to collect OHOS device logs during app deployment?

Collecting OHOS device logs during app deployment is handled by integrating log retrieval directly into the build and run cycle, capturing output immediately after launching the application.

Do I need to manually configure JAVA_HOME and hvigorw to build HarmonyOS apps?

Manual configuration of JAVA_HOME and hvigorw is unnecessary because the workflow auto-detects these tools and configures the environment automatically if no system JDK is present.

Can I customize the module and product settings for my HarmonyOS build?

You can customize the HarmonyOS build by specifying variables such as PROJECT_ROOT, MODULE, PRODUCT, and BUNDLE in the configuration to suit different project requirements.

Why does the HarmonyOS one-stop build require a SKILL.md file?

The HarmonyOS one-stop build requires a SKILL.md file containing valid YAML frontmatter with name and description fields to define the execution context and configuration parameters.