首页/新闻资讯/正文详情

DevEco CLI命令速查表:从create、build到signature的HarmonyOS命令行工具全景

发布时间:2026/9/25 3:18:57 来源:云帆数科 栏目:资讯中心
DevEco CLI命令速查表:从create、build到signature的HarmonyOS命令行工具全景
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),仅供参考

相关推荐

使用 @turf/circle 生成圆多边形:Turf 地理引擎中的半径圆缓冲区实战指南
使用 @turf/circle 生成圆多边形:Turf 地理引擎中的半径圆缓冲区实战指南

数据分析 【免费下载链接】turf A modular geospatial engine written in JavaScript and TypeScript 项目地址: https://gitcode.com/gh_mirrors/tu/turf 点击查看 免费下载 turf/circle 是 Turf 模块化地理引擎中用于“以指定点为圆心、按给定半径生成圆形多边形… · 2026/9/25 3:18:57

SHX字体缺失导致DWG乱码?从原理到批量修复的完整指南
SHX字体缺失导致DWG乱码?从原理到批量修复的完整指南

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/9/25 3:18:45

ESP32 运行 WebAssembly 实战:WAMR 原理、内存模型与 AOT 性能优化
ESP32 运行 WebAssembly 实战:WAMR 原理、内存模型与 AOT 性能优化

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/9/25 3:18:45

PX4 外设指南:CUAV NEO 3 双频多星座 GPS 模块集成与源码级原理解析
PX4 外设指南:CUAV NEO 3 双频多星座 GPS 模块集成与源码级原理解析

嵌入式物联网机器人自动驾驶智能硬件 【免费下载链接】PX4-Autopilot PX4 Autopilot Software 项目地址: https://gitcode.com/gh_mirrors/px/PX4-Autopilot 点击查看 免费下载 CUAV NEO 3 是面向 PX4 Autopilot 生态设计的 GNSS 定位模块,单模块同时集… · 2026/9/25 3:53:58

mongo-go-driver 提交前验证(Pre-PR Validation)全流程指南:task 流水线、API 变更检测与提交规范
mongo-go-driver 提交前验证(Pre-PR Validation)全流程指南:task 流水线、API 变更检测与提交规范

数据库文档数据库后端 【免费下载链接】mongo-go-driver The Official Golang driver for MongoDB 项目地址: https://gitcode.com/gh_mirrors/mo/mongo-go-driver 点击查看 免费下载 mongo-go-driver 是 MongoDB 官方 Go 驱动,仓库中内置了一套面向开发… · 2026/9/25 3:53:58

深入 reflect2:buildah 依赖树中绕过 reflect.Value 开销的轻量反射方案
深入 reflect2:buildah 依赖树中绕过 reflect.Value 开销的轻量反射方案

云原生 【免费下载链接】buildah A tool that facilitates building OCI images. 项目地址: https://gitcode.com/gh_mirrors/bu/buildah 点击查看 免费下载 本文基于 buildah 仓库中 vendored 的 reflect2 说明文档 展开,讲清楚这个"避开 runtime… · 2026/9/25 3:53:58

cube-ui 快速上手:脚手架初始化、编译配置与按需引入实战
cube-ui 快速上手:脚手架初始化、编译配置与按需引入实战

前端UI组件移动开发 【免费下载链接】cube-ui :large_orange_diamond: A fantastic mobile ui lib implement by Vue 项目地址: https://gitcode.com/gh_mirrors/cu/cube-ui 点击查看 免费下载 cube-ui 是一套由滴滴开源、基于 Vue 实现的移动端 UI 组件库&#xf… · 2026/9/25 3:53:58

铝氧化厂生产管理软件怎么选?从接单到对账的闭环实操指南
铝氧化厂生产管理软件怎么选?从接单到对账的闭环实操指南

干铝氧化这行十几年,车间里最头疼的从来不是槽液,而是账和单子。一车铝件进厂,客户改口说颜色不对;明明记得做了,出货单上找不着;月底跟客户对账,翻破三本手写单还是漏了两笔。后来换了一套氧化… · 2026/9/25 3:53:58

神经编程调试与测试资源重构:从依赖网络到可推理的资产体系
神经编程调试与测试资源重构:从依赖网络到可推理的资产体系

凌晨两点十七分,测试环境监控弹出一片红色告警。第二天早上要发版,自动化回归挂了236条用例,覆盖了核心交易链路。我们第一反应是代码出了问题,立刻拉上研发一起看git提交记录、翻日志、在IDE里断点调试。折腾到凌晨四点&#xff… · 2026/9/25 3:53:52

数值优化(Numerical Optimization)学习系列-03-共轭梯度方法(Conjugate Gradient)
数值优化(Numerical Optimization)学习系列-03-共轭梯度方法(Conjugate Gradient)

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/9/25 1:00:31

创维E900V22D刷机全攻略:S905L3SB芯片兼容性解析与救砖实战
创维E900V22D刷机全攻略:S905L3SB芯片兼容性解析与救砖实战

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/9/25 1:00:31

MQTT协议原理与Broker服务器搭建实战:从Mosquitto到EMQX
MQTT协议原理与Broker服务器搭建实战:从Mosquitto到EMQX

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/9/25 1:00:37

了解更多?预约专属演示

我们的顾问将为您一对一讲解产品与方案

企业微信二维码