harmonyos-app-dev

Guide HarmonyOS NEXT app development with ArkTS and ArkUI.

5|Updated Apr 16, 2026
One-click install
npx skills add https://github.com/zhuang-HE/harmonyos-app-dev --skill harmonyos-app-dev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: harmonyos-app-dev
Source: https://github.com/zhuang-HE/harmonyos-app-dev/tree/main
Command: npx skills add https://github.com/zhuang-HE/harmonyos-app-dev --skill harmonyos-app-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill provides a comprehensive guide for developing applications on HarmonyOS NEXT, covering everything from environment setup to app deployment and review.

Core Features & Use Cases

  • Full-Stack Coverage: 22 chapters on the full development lifecycle, including technology selection, environment setup, ArkTS development, debugging, and app review.
  • Real-World Challenges: 40+ practical problems and solutions from the OpenClaw HarmonyOS version app, covering compilation errors, configuration errors, runtime errors, and more.
  • V1/V2 Decision Tree: Helps determine the appropriate version of @Observed/@State (V1) or @ObservedV2/@Trace (V2), and provides a complete solution for mixed usage crashes.
  • ArkTS Strict Mode Manual: Correct usage of object literals, for...in, dynamic imports, and deprecated APIs.
  • Stage Model and Card Development: Complete guide on UIAbility lifecycle, cross-device transitions, and meta-service development.
  • Performance Optimization & hdc Debugging: Real-device testing techniques, memory optimization, hvigor build tuning, and hilog log collection.
  • Use Case: A developer can use this Skill to quickly resolve a specific ArkTS compilation error or learn about the best practices for building a HarmonyOS app.

Quick Start

Use the harmonyos-app-dev skill to find information on ArkTS compilation errors.

Frequently Asked Questions about harmonyos-app-dev

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

FAQPage Schema
How do I resolve ArkTS strict mode compilation errors in HarmonyOS NEXT?

To resolve ArkTS compilation errors, correct object literals, for...in loops, and deprecated APIs according to the ArkTS strict mode manual. This guide provides solutions for 40+ real-world compilation and configuration issues from OpenClaw.

How do I choose between @Observed/@State V1 and @ObservedV2/@Trace V2 for HarmonyOS state management?

Choosing state management versions requires using the V1/V2 decision tree to evaluate your component's reactivity needs. This guide helps determine the appropriate version and provides complete solutions for mixed usage crashes.

What's the best way to debug HarmonyOS applications using hdc on a real device?

The best way to debug HarmonyOS applications is using hdc for real-device testing, hilog log collection, and memory optimization. This guide covers techniques for capturing runtime errors and analyzing device performance.

How do I manage the UIAbility lifecycle in the HarmonyOS Stage model?

Managing the UIAbility lifecycle in the Stage model involves handling cross-device transitions and meta-service development. This guide provides a complete walkthrough for building Stage model applications and card development.

Do I need prior programming experience to use this HarmonyOS development guide?

You need basic programming skills and knowledge of the HarmonyOS NEXT development environment to use this guide effectively. It covers the full lifecycle from environment setup to app deployment and review for developers.

Why does my HarmonyOS app crash when mixing V1 and V2 state management decorators?

HarmonyOS apps crash when mixing V1 and V2 state decorators due to incompatible reactivity tracking mechanisms. This guide provides a complete solution for resolving these mixed usage crashes using the V1/V2 decision tree.