让 AI 帮你编译部署鸿蒙应用：harmonyos-build-deploy Skill

让 AI 帮你编译部署鸿蒙应用：harmonyos-build-deploy Skill

这不是一篇教你敲命令的文章。这是一篇关于如何让 AI 成为你的鸿蒙开发助手，帮你完成从编译到部署全流程的实践分享。

为什么要做这个 Skill？

不是给开发者用的，是给 AI 用的

传统的 CLI 工具设计理念是：开发者学习命令 → 开发者执行命令。

但在 AI Coding 时代，我们有了新的可能：开发者描述需求 → AI 理解并执行。

harmonyos-build-deploy 的设计初心就是：

让 Claude 能够理解鸿蒙项目，自动完成编译、签名、部署、调试的全流程。开发者只需要用自然语言描述需求。

什么是 Claude Code Skill？

Claude Code 是 Anthropic 推出的 AI 编程助手。Skill 是一种扩展机制，可以教会 Claude 特定领域的知识和能力。

当你安装了 harmonyos-build-deploy Skill 后，Claude 就具备了：

• 🧠 理解鸿蒙项目结构（HAP/HSP/HAR 模块）
• 🔧 知道如何使用 hvigorw、hdc、ohpm 等工具
• 📦 能够分析模块依赖并按正确顺序编译
• 📱 可以将应用部署到真机并启动
• 🏪 能够打包 .app 文件用于上架 AppGallery

实际使用场景

场景 1：日常开发调试

你只需要说：

帮我编译一下这个鸿蒙项目，部署到手机上运行

Claude 会自动：

场景 2：切换环境

你只需要说：

切换到生产环境，用 release 模式重新打包部署

Claude 理解后执行：

npx harmonyos-deploy –all -p production –release –launch

场景 3：调试问题

你只需要说：

应用好像有问题，帮我看看设备日志，过滤 NetworkError 相关的

Claude 会：

npx harmonyos-deploy –log-only –filter NetworkError

然后帮你分析日志内容，定位问题。

场景 4：准备上架

你只需要说：

项目开发完了，帮我打个包准备上架华为应用市场

Claude 会：

npx harmonyos-deploy –app -p production –release -o ./dist

AI + Skill 的协作模式

传统方式 vs AI Coding

Skill 如何工作

┌─────────────────────────────────────────────────────────────┐
│ 开发者 │
│ "帮我编译部署" │
└─────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────┐
│ Claude Code │
│ 1. 理解用户意图：编译 + 部署 │
│ 2. 识别项目类型：检测到 build-profile.json5 → 鸿蒙项目 │
│ 3. 调用 Skill：harmonyos-build-deploy │
│ 4. 执行命令：npx harmonyos-deploy –all –launch │
│ 5. 处理结果：成功/失败 → 反馈给用户 │
└─────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────┐
│ harmonyos-deploy CLI │
│ • ohpm install │
│ • hvigorw assembleHap/assembleHsp │
│ • hdc install │
│ • aa start │
└─────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────┐
│ 鸿蒙设备 │
│ 应用成功运行 │
└─────────────────────────────────────────────────────────────┘

如何开始使用

方式 1：在 Claude Code 中安装 Skill

# 安装 skill
/skill install harmonyos-build-deploy

安装后，Claude 就会在你提到鸿蒙编译、部署、hvigor、hdc 等关键词时自动激活这个 Skill。

方式 2：直接使用（无需 Skill）

即使不安装 Skill，你也可以在对话中引导 Claude 使用这个工具：

我的项目是鸿蒙应用，请使用 npx harmonyos-deploy 来帮我编译部署

方式 3：项目级配置

在项目根目录创建 .claude/skills/ 文件夹，将 Skill 文件放入，Claude 会自动加载。

触发关键词

当你在对话中提到以下关键词时，Claude 会自动识别并使用 harmonyos-build-deploy：

• 鸿蒙、HarmonyOS、OpenHarmony
• 编译、构建、部署、安装
• hvigor、hvigorw、hdc
• HAP、HSP、HAR
• AppGallery、上架
• ohpm、hilog

Skill 的技术实现

零依赖设计

整个工具是一个约 1900 行的 Node.js 脚本，不依赖任何第三方 npm 包。这意味着：

• ✅ 无需 npm install
• ✅ 直接 npx 运行
• ✅ AI 可以立即使用

智能依赖解析

对于多模块项目，工具会：

lushu_acommon (无依赖)
↓
lushu_appcommon (依赖 acommon)
↓
lushu_home, lushu_service… (依赖 acommon + appcommon)
↓
entry (HAP，最后编译)

错误诊断

当编译或安装失败时，工具会分析错误并给出修复建议，AI 可以直接将这些信息呈现给你。

未来展望

更深度的 AI 集成

• 🔮 AI 直接修改代码后自动重新编译部署
• 🔮 AI 分析运行时日志，自动定位并修复 Bug
• 🔮 AI 根据测试结果自动优化性能

更完整的 DevOps 支持

• 🔮 自动化测试集成
• 🔮 多设备并行部署
• 🔮 版本管理和发布流程

开源地址

• GitHub: https://github.com/supermanaaaa/harmonyos-build-deploy
• npm: https://www.npmjs.com/package/harmonyos-deploy
• Claude Skills: 已提交至 anthropics/skills

总结

harmonyos-build-deploy 不仅仅是一个 CLI 工具，更是连接 AI 能力 和 鸿蒙开发 的桥梁。

它的存在让 Claude 能够：

• 理解鸿蒙项目的结构和构建流程
• 执行复杂的多模块编译
• 处理设备部署和调试
• 完成应用上架打包

而你只需要：

• 用自然语言描述需求
• 让 AI 帮你完成剩下的工作

这就是 AI Coding 时代的开发方式。

作者：supermanaaaa

项目地址：https://github.com/supermanaaaa/harmonyos-build-deploy

如果这个 Skill 对你有帮助，请给个 ⭐️ Star 支持一下！