DevEco CLI 快速入门：让 AI Agent 更懂 HarmonyOS 应用开发

本原创文章帖发布在 华为开发者联盟社区 ，欢迎开发者前往访问评论交流，更多与该内容相关讨论，请点击原帖查看： DevEco CLI 快速入门：让 AI Agent 更懂 HarmonyOS 应用开发

各位开发者好！随着 AI 辅助研发成为日常，许多开发者和团队都已经用上了各种本地 AI 编码助手或自研的 AI Agent 工具。那么，如何让这些现有的 AI Agent 快速掌握 HarmonyOS 应用开发的能力？

华为推出的 DevEco CLI 正是为此而生，它定位于统一集成开发工具链和 HarmonyOS 知识库，是专为 AI Agent 打造的原子化能力调度枢纽。

今天我们直接从实操入手，教你如何将 HarmonyOS 能力接本地 AI 工作流。它本质上是将 DevEco Studio 工具链统一封装为一个 CLI，内置 ohpm、hvigor、hdc、emulator、hilog，同时集成 HarmonyOS 技能安装、项目脚手架、本地 HarmonyOS 文档检索和 MCP 服务。

1、DevEco CLI 环境依赖与配置要求说明

DevEco CLI 是基于 DevEco Studio 工具链封装的命令行工具。它依赖于已安装并配置好环境的 DevEco Studio（包含 ohpm、hvigor 等工具），通过命令行接口提供项目构建、设备调试等功能，旨在提升自动化脚本和 CI/CD 流程的效率。

• 操作系统为 macOS 或 Windows

• Node.js >= 18，推荐使用 22 及以上版本

• DevEco Studio >= 6.1.0

• macOS：必须安装在 ~/Applications 或 /Applications 目录下。

稳定版： npm install -g @deveco/deveco-cli@stable

尝鲜版： npm install -g @deveco/deveco-cli

2、一键集成现有 AI Agent（以 OpenCode 为例）

如果你正在使用本地 AI Agent 工具（例如基于 OpenCode 开发应用），将 DevEco CLI 接入你的工作流非常简单。它能为 AI Agent 专门提供结构化（如 JSON）的数据流，完美兼容 Agent 驱动开发的范式。

实操命令： 只需在终端运行以下初始化指令： devecocli init 运行该指令后即可完成深度集成。你的 AI Agent 甚至可以自主指挥 DevEco CLI 去安装更多用于 HarmonyOS 应用开发的精品 Skills。

3、让 AI Agent 调度端到端研发原子能力

接入完成后，你的 AI Agent 就可以自动推进整个研发流程。你可以通过提示词或脚本，让 Agent 执行以下操作：

• 工程初始化 ：调用 create 命令，让 Agent 基于官方模板快速生成项目工程结构。

• 编译与构建 ：调用 build 命令驱动 hvigor 构建系统，自动处理 HAP 打包、多目标产物构建及代码签名。

• 模拟器与运行 ：使用 device / emulator 和 run 命令统一管理设备生命周期，自动完成安装、权限配置并启动应用。

• 实时语法检查与编译前错误拦截 ：Check MCP 为模型提供实时语法检查和编译修复工具能力，支持 ArkTS 和 C++ 语法检查，无需耗时编译即可实时发现错误，大幅缩短反馈链路，使 Agent 修复效率提升 5 倍以上。

同时 DevEco CLI 内置最新官方知识文档与极速检索，让 AI Agent 更懂 HarmonyOS。它能让裸模型获取官网最新 API，而非过时信息。

在实操命令与场景中： 你可以引导你的 AI Agent 在生成代码前，先执行以下查询命令： harmonyos knowledge "ArkUI 组件生命周期" 通过查询官方最新的 API 文档和最佳实践，确保它生成的代码严格遵循官方规范。下面是开发全流程展示：

DevEco CLI 不仅提供工具和知识，也内置 70+精品 Skills 沉淀 HarmonyOS 应用开发中的实践经验，覆盖多设备场景适配开发、知识检索、ArkTS 语法、应用质量等关键场景，帮助开发者提升开发效率和应用质量。

下面以多设备适配 Skills 为例，AI Agent 可结合多设备 Skills 生成更符合设备特性的布局与交互方案，避免简单拉伸、布局错乱等问题，大幅降低多设备适配的人力开发成本。

以上内容展示了 DevEco CLI 的 AI 能力。现将 DevEco CLI 1.2.0 新版本上线特性汇总如下：

构建并产出 .hap / .hsp / .har / .app，支持 --product、–modules（module@target）、–build-mode；多个构建命令对同一目录操作时通过锁机制串行等待

构建后安装并启动应用，支持 --module、–device、–product、–build-mode、–ability、–uninstall、–skip-build，支持多包运行，兼容在线签名场景

基于 Empty Ability 模板脚手架创建 HarmonyOS 工程，支持 --app-name、–project-path、–bundle-name、–api-level，API 级别从 SDK 动态获取并校验

device list 查询真机与运行中模拟器，device view 查询设备详情，支持 --target 按名称或序列号选择，支持过滤未授权（unauthorized）设备

新增模拟器实例管理（list / start / stop / create / delete）、镜像管理（image list / download / remove）与协议管理（license view / accept），start 使用 snapshot 快速启动模式

技能市场管理（list / find / add / remove），支持多标签查询、–project 项目级与 --path 任意路径安装、下载校验与安装性能优化

将 deveco-cli 技能或 MCP 服务配置到智能体，–skill 与 --mcp 互斥，支持工程级与用户级 MCP

启动内置 MCP 服务，提供基于 LSP 的 ArkTS / C++ 语法检查，支持工程级 MCP 配置

本地 HarmonyOS 文档检索（search / read / catalog），标题命中关键词优先排序

查看 hilog 普通日志与崩溃日志，支持 --level、–bundle-name、–keyword、–tail、–from / --to 时间窗与 --follow 实时跟随；流式命令执行

👉 开源项目地址：欢迎前往 GitCode 查看项目详情并体验： https://gitcode.com/openharmony-sig/deveco-cli

HarmonyOS 白皮书： 鸿蒙应用AI辅助研发新范式技术报告

开发者实践： DevEco Code 和 CLI实践专题

课程视频： HarmonyOS应用AI开发工具--DevEco CLI