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-clistable尝鲜版npm install -g deveco/deveco-cli2、一键集成现有 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 文档和最佳实践确保它生成的代码严格遵循官方规范。下面是开发全流程展示让 AI Agent 调度端到端研发原子能力视频4、调用现有精品 SkillsDevEco CLI 不仅提供工具和知识也内置70精品 Skills 沉淀 HarmonyOS 应用开发中的实践经验覆盖多设备场景适配开发、知识检索、ArkTS语法、应用质量等关键场景帮助开发者提升开发效率和应用质量。下面以多设备适配 Skills 为例AI Agent 可结合多设备 Skills 生成更符合设备特性的布局与交互方案避免简单拉伸、布局错乱等问题大幅降低多设备适配的人力开发成本。以上内容展示了 DevEco CLI 的 AI 能力。现将 DevEco CLI 1.2.0 新版本上线特性汇总如下build构建并产出 .hap / .hsp / .har / .app支持 --product、–modulesmoduletarget、–build-mode多个构建命令对同一目录操作时通过锁机制串行等待run构建后安装并启动应用支持 --module、–device、–product、–build-mode、–ability、–uninstall、–skip-build支持多包运行兼容在线签名场景create基于 Empty Ability 模板脚手架创建 HarmonyOS 工程支持 --app-name、–project-path、–bundle-name、–api-levelAPI 级别从 SDK 动态获取并校验devicedevice list 查询真机与运行中模拟器device view 查询设备详情支持 --target 按名称或序列号选择支持过滤未授权unauthorized设备emulator新增模拟器实例管理list / start / stop / create / delete、镜像管理image list / download / remove与协议管理license view / acceptstart 使用 snapshot 快速启动模式skills技能市场管理list / find / add / remove支持多标签查询、–project 项目级与 --path 任意路径安装、下载校验与安装性能优化init将 deveco-cli 技能或 MCP 服务配置到智能体–skill 与 --mcp 互斥支持工程级与用户级 MCPserve mcp启动内置 MCP 服务提供基于 LSP 的 ArkTS / C 语法检查支持工程级 MCP 配置docs本地 HarmonyOS 文档检索search / read / catalog标题命中关键词优先排序log查看 hilog 普通日志与崩溃日志支持 --level、–bundle-name、–keyword、–tail、–from / --to 时间窗与 --follow 实时跟随流式命令执行update升级到最新版本免重复安装 开源项目地址欢迎前往 GitCode 查看项目详情并体验deveco-cli:集成HarmonyOS应用开发工具集提供知识文档和精品Skills支持多种智能体助力开发者使用AI辅助高效开发HarmonyOS应用。 - AtomGit 推荐学习资源HarmonyOS白皮书鸿蒙应用AI辅助研发新范式技术报告开发者实践DevEco Code 和 CLI实践专题开发指南DevEco CLI 文档课程视频HarmonyOS应用AI开发工具--DevEco CLI对于拥有既定研发流程的团队来说DevEco CLI 是将 HarmonyOS 能力接入您现有 AI 体系的强有力辅助。立即安装 DevEco CLI开始你的 HarmonyOS AI 开发之旅如果您在使用过程中有任何心得欢迎在评论区留言我们一起交流探讨