Verified:GitHub

openharmony-build

Orchestrate OpenHarmony builds and analyze errors from build.log.

Updated Sep 22, 2023

One-click install

npx skills add https://github.com/eclipse-oniro-mirrors/arkui_ace_engine --skill openharmony-build-eclipse-oniro-mirrors

Or copy as Structured Prompt for Agent▼

Please help me install this Agent Skill.
Skill: openharmony-build
Source: https://github.com/eclipse-oniro-mirrors/arkui_ace_engine/tree/main/.claude/skills/openharmony-build
Command: npx skills add https://github.com/eclipse-oniro-mirrors/arkui_ace_engine --skill openharmony-build-eclipse-oniro-mirrors

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This skill orchestrates the end-to-end OpenHarmony build workflow, including execution, verification, and post-build analysis to quickly identify issues and reduce debugging time.

Core Features & Use Cases

Full-system and component builds: Build the complete OpenHarmony system or targeted components such as ace_engine, ace_engine_test, unittest, and ohos-sdk.
SDK builds with special output handling: Support for building OpenHarmony SDK with its unique out/sdk structure.
Rapid iteration with fast-rebuild: Skip GN generation when possible to speed up development and testing.
Error detection and diagnostics: Analyze out/<product>/build.log and per-component logs, with utilities to extract recent errors and problematic sections.
Workflow automation: Provides scripts to navigate to root, trigger builds, run analysis, and guide recovery steps after failures.

Quick Start

Navigate to the OpenHarmony root (the directory containing .gn), then run a full build with caching enabled. Example: run ./build.sh --export-para PYCACHE_ENABLE:true --product-name rk3568 --ccache. Monitor the result in out/rk3568/build.log. If errors occur, use the included analysis scripts located at .claude/skills/openharmony-build/scripts to extract errors and guide remediation.

Frequently Asked Questions about openharmony-build

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

FAQPage Schema

How do I automate OpenHarmony builds and diagnose failures?▼

Automate OpenHarmony builds by orchestrating the end-to-end workflow from root to artifacts, then diagnose failures through post-build analysis of out/<product>/build.log to extract recent errors and problematic sections.

How do I run a fast-rebuild in OpenHarmony to skip GN generation?▼

Run a fast-rebuild in OpenHarmony to skip GN generation when possible, enabling rapid iteration and significantly speeding up development and testing cycles for full-system or component builds.

How do I analyze build logs to find recent errors in OpenHarmony component builds?▼

Analyze OpenHarmony build logs by using included scripts to extract recent errors and problematic sections from out/<product>/build.log and per-component logs, guiding recovery steps after failures.

Can I build specific OpenHarmony components like ace_engine instead of the full system?▼

Build specific OpenHarmony components like ace_engine, ace_engine_test, unittest, and ohos-sdk directly, executing targeted test lists instead of forcing a complete full-system build every time.