DevEco CLI命令速查表从create、build到signature的HarmonyOS命令行工具全景【免费下载链接】deveco-cli集成HarmonyOS应用开发工具集提供知识文档和精品Skills支持多种智能体助力开发者使用AI辅助高效开发HarmonyOS应用。项目地址: https://gitcode.com/openharmony-sig/deveco-cli本文带你快速掌握 HarmonyOS 命令行工具的完整命令体系。DevEco CLI命令devecocli是一套集成 HarmonyOS 应用开发的统一命令行工具集一条命令覆盖创建工程 → 构建 → 运行 → 查日志 → UI 自动化 → 应用签名全流程还内置本地文档检索与 AI 智能体技能。什么是 DevEco CLIDevEco CLI 将 DevEco Studio 工具链统一封装为命令行入口内置ohpm、hvigor、hdc、emulator、hilog能力并集成 HarmonyOS 技能安装、项目脚手架、本地文档检索和 MCP 服务。支持 macOS、Windows、Linux。环境要求最低版本Node.js≥ 22DevEco Studio≥ 6.0.0Command Line Tools≥ 26.0.0Linux 必选一行命令全局安装npm install -g deveco/deveco-clilatest命令全景15 个顶层命令速查表 下面是 DevEco CLI 命令速查表的核心覆盖全部顶层命令源码入口见 packages/cli/src/cli.ts命令用途最小示例create脚手架新建 HarmonyOS 工程devecocli create --app-name MyAppbuild构建产出.hap/.hsp/.har/.appdevecocli build --build-mode releaserun安装并运行应用附冒烟检查devecocli run --device 127.0.0.1:5555log查看 hilog 普通日志或崩溃日志devecocli log --level Edevice查看设备、传文件、执行 sqlite3devecocli device listemulator模拟器管理与场景模拟devecocli emulator start Phoneui截图、录屏、点击、滑动、布局导出devecocli ui screenshot --path ./shotschecklint / ArkTS 静态检查 / API 兼容扫描devecocli check lintdocs搜索、阅读本地 HarmonyOS 文档devecocli docs search 沉浸光感skills管理 HarmonyOS 技能市场技能devecocli skills add --allinit给 AI 智能体配置 Skill 或 MCPdevecocli init --mcp --agent opencodeserve启动本地 MCP / LSP 服务devecocli serve mcpsignature自动生成调试签名材料devecocli signature generateauth华为开发者账号登录与团队管理devecocli auth loginupdate升级 CLI 到最新版本devecocli update最短工作流从 create 到 run 日常开发只需记住这四步完整参数详见 README.mddevecocli create --app-name MyApp cd MyApp devecocli run devecocli log --level E1️⃣ create —— 一行命令创建 HarmonyOS 工程create基于内置Empty Ability模板生成工程骨架模板源码见 packages/cli/templates/devecocli create --app-name MyApp常用参数说明--app-name必选应用名称--project-path工程路径默认./app-name--bundle-name包名默认com.example.app-name--api-levelAPI 级别最小 17上限取自已安装 SDK2️⃣ build —— 构建打包出产物devecocli build --build-mode release devecocli build --modules entry library devecocli build clean # 清理构建产物只构建工程时产出.app指定--modules时按模块产出.hap/.hsp/.har模块依赖会自动解析构建。3️⃣ run —— 一键安装运行自带冒烟检查run完成构建 → 安装 → 启动并在启动后自动执行冒烟检查进程存活 截图空白屏检测失败会输出崩溃日志或截图路径命令以非零码退出方便接入 CI。devecocli run devecocli run --uninstall # 先卸载再安装 devecocli run --hotreload # 开启热重载stop 子命令停止4️⃣ log —— hilog 日志与崩溃日志排查devecocli log --level E devecocli log --crash --bundle-name com.example.app devecocli log --follow --tail 100--level支持D/I/W/E/F五个级别--keyword、--from/--to可按关键词和时间窗过滤实现类tail -f的实时日志跟踪。device 与 emulator真机和模拟器管理 device —— 设备侧操作子命令作用device list查看所有已连接设备真机 运行中的模拟器device view查看设备序列号、名称、类型、OS 版本device file send/recv主机与设备间传文件device sqlite3直接在设备上执行 sqlite3 查询emulator —— 模拟器的完整生命周期实例管理emulator list/start/stop/create/delete镜像管理emulator image list/image download/image remove许可协议emulator license accept自动化脚本推荐非交互直接同意更强大的是场景模拟可远程控制运行中的模拟器震动、开关机、旋转屏幕、音量、折叠状态、电量、GPS 定位、运动场景跑步/骑行/驾车导航、传感器心率/温度/湿度等devecocli emulator battery --target Phone --level 20 devecocli emulator geolocation --target Phone --longitude 116.4 --latitude 39.9uiUI 检查与自动化操作全家桶 ️ui子命令面向真机与模拟器是 UI 调试与自动化测试的核心子命令作用ui screenshot对真机或模拟器截图ui screenrecord录制真机屏幕为 MP4ui click/doubleclick/longclick点击、双击、长按支持坐标或节点 IDui swipe/fling/drag/dircfling滑动、快速滑动、拖拽、按方向滑动ui text向焦点或指定节点输入文本ui layout导出 UI 节点树类型、ID、坐标、文本、可交互标志ui window list查看窗口列表为 layout/click 提供窗口 ID典型调试链路ui window list拿窗口 ID →ui layout拿节点 ID 和坐标 →ui click --id xxx精准点击无需手算坐标。docs 与 skills本地文档检索与 AI 技能集成 docs —— 离线 HarmonyOS 文档检索无需联网即可搜索版本说明、指南、API 参考、最佳实践、FAQ 等分类devecocli docs catalog # 查看文档分类 devecocli docs search State --catalog best-practices devecocli docs read documentId # 按 ID 读完整文档 devecocli update docs # 更新到最新兼容版本skills init serve —— 让 AI 智能体帮你写 HarmonyOS 应用命令作用skills list/find查询与搜索可用 HarmonyOS 技能skills add/remove将技能安装到或移出智能体init --agent 名称给指定 AI 智能体安装 CLI 技能init --mcp --project 路径为工程配置 MCP 服务serve mcp启动本地 MCP 服务serve lsp --arkts/--cpp启动 ArkTS / C 语言服务配置 MCP 后智能体可通过check、hover、definition、references、callHierarchy等工具直接调用代码分析与语言特性例如让 Agent检查这个 .ets 文件的语法错误或构建 release 包并运行到模拟器。check 与 signature代码质量和应用签名 check —— 三种质量检查子命令作用check lint代码规范检查支持--fix自动修复、增量检查check arkts对.ets文件执行 ArkTS 静态检查check compat扫描两个 SDK 版本间的 API 变更支持文件/模块/工程级signature —— 一键生成调试签名signature generate自动生成 p12 密钥库、csr 请求文件、p7b 配置和 cer 证书并把签名配置写入项目的build-profile.json5省去手动申请证书的步骤devecocli signature generate devecocli signature generate --force # 覆盖已有证书auth 与 update账号登录和版本升级 ⬆️devecocli auth login # 浏览器授权登录华为开发者账号 devecocli auth status # 查看当前登录用户 devecocli auth team list # 列出已加入团队 devecocli update # 升级到最新版实用技巧清单 随时查帮助devecocli --help或任意子命令加--help无需记忆全部参数。机器可读输出多数查询命令支持--format json方便脚本处理。多设备场景连接多台设备时--device名称或序列号为必填。非默认安装路径设置DEVECO_CLI_STUDIO_PATH或DEVECO_CLI_CLT_PATH显式指定工具链优先级Studio CLT 自动检测。排查底层命令设置DEVECO_CLI_DEBUG1可查看实际执行的 hdc/Emulator 命令。总结DevEco CLI 把 HarmonyOS 命令行工具整合为一条devecoclicreate起步、build构建、run运行、log排查、emulator/ui调试、signature收尾再加上docs本地文档与skills/init的 AI 集成构成覆盖开发全流程的 HarmonyOS 命令行工具全景。建议收藏本文的速查表配合--help按需深入让 HarmonyOS 开发更顺手。【免费下载链接】deveco-cli集成HarmonyOS应用开发工具集提供知识文档和精品Skills支持多种智能体助力开发者使用AI辅助高效开发HarmonyOS应用。项目地址: https://gitcode.com/openharmony-sig/deveco-cli创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考