hdc（OpenHarmony Device Connector）是 OpenHarmony 为开发人员提供的用于调试的命令行工具，通过该工具可以在Windows/Linux/MacOS等系统上与开发机或者模拟器进行交互。

下文将介绍hdc的环境准备和常用命令及使用举例。

环境准备

hdc 工具获取方式：

通过OpenHarmony sdk获取，hdc在sdk的toolchains目录下。

使用举例：

下面以linux侧使用方式举例：

获取linux的sdk，然后配置环境变量：

export HDC_SERVER_PORT=7035

export HDC_HOME=/app/software/command-line-tools/sdk/default/openharmony

export PATH=$PATH:$HDC_HOME/toolchains

注意事项

• 使用hdc，如果出现异常，可以尝试通过hdc kill命令杀掉hdc服务，或者通过hdc start -r命令重启服务进程进行解决。
• 如果出现hdc list targets获取不到设备信息，通过任务管理器查看是否有hdc进程存在，如果进程存在，可以通过杀掉该进程进行解决。

option相关的命令

option涉及以下命令：

• -h/help -v/version 用于显示hdc相关的帮助、版本信息。
• 表1 命令说明
• 返回值返回值说明返回对应信息帮助或者版本信息
• 使用方法：
• hdc -h / hdc help hdc -v / hdc version
• -l 0-5 用于指定运行时日志等级,默认为LOG_INFO。
• 命令说明

• 使用方法：
• hdc -l5 start
• -t key 用于连接指定设备标识为key的设备。

命令说明

• 使用方法：
• 该option需要与具体的操作命令搭配使用，下面以shell命令举例：
• hdc list targets （获取设备信息）
• hdc -t key shell （-t后面添加的_key_ 需要替换为上面查询的设备信息）
• 说明： 一台开发机可支持多个设备连接，每个设备有其唯一的设备标识，如果通过网络与设备连接,其标识为IP地址:port格式，如果通过USB连接则标识为设备sn号。该命令需要跟随具体操作命令。
• checkserver 用于获取client-server版本。

命令说明

使用方法：

hdc checkserver

查询设备列表的命令

查询设备列表涉及以下命令：

list targets[-v]

显示所有已经连接的目标设备列表

命令说明

使用方法：

hdc list targets

hdc list targets -v

服务进程相关命令

服务进程涉及以下命令：

• target mount 以读写模式挂载系统分区。

命令说明

• 使用方法：
• hdc target mount
• target boot 设备重启。
• 使用方法：
• hdc target boot
• smode [-r] 授予后台服务进程root权限， 使用-r参数取消授权。
• 使用方法：
• hdc smode hdc smode -r
• kill [-r] 终止服务进程。

命令说明

• 
  
• 使用方法：
• hdc kill
• start [-r] 启动服务进程。

命令说明

• 使用方法：
• hdc start

网络相关的命令

网络部分涉及以下命令：

• tconn host[:port][-remove] 通过【ip地址：端口号】来指定连接的设备

命令说明

• 
  
• 使用方法（举例）：
• hdc tconn 192.168.0.100:8710
• tmode usb 执行后设备端对应daemon进程重启，并首先选用USB连接方式。

命令说明

• 
  
• 使用方法：
• hdc tmode usb
• tmode port port-number 执行后设备端对应daemon进程重启，并优先使用网络方式连接设备，如果连接设备失败，再选择USB连接。

命令说明

• 
  
• 使用方法：
• hdc tmode port 8710
• 说明： 执行完毕后，远端daemon将会退出并重启，默认启用TCP连接，如果不加上listen端口则listen随机端口。
• fport localnode remotenode 端口转发，指定 主机端口 转发数据到 设备侧端口。
• 使用方法：
• hdc fport tcp:1234 tcp:1080
• rport remotenode localnode 端口转发，指定 设备侧端口 转发数据到 主机端口。
• 使用方法：
• hdc rport tcp:2080 tcp:2345
• fport ls 列出全部转发端口转发任务。

命令说明

• 使用方法：
• hdc fport ls
• fport rm 删除指定端口转发任务。
• 使用方法：
• hdc fport rm tcp:1234 tcp:1080

文件相关的命令

文件部分涉及以下命令：

• file send local remote 发送文件至远端设备。

命令说明

• 
  
• 使用方法（举例）：
• hdc file send E:\a.txt /data/local/tmp/a.txt
• file recv [-a] remote local 从远端设备接收文件至本地。

命令说明

• 使用方法（举例）：
• hdc file recv /data/local/tmp/a.txt ./a.txt

应用相关的命令

应用部分涉及以下命令：

• install [-r/-d/-g] package 安装OpenHarmony APP package。

命令说明

• 使用方法（举例）：
• hdc install hwadmin.hap
• uninstall [-k] package 卸载OpenHarmony应用。

命令说明

• 使用方法（举例）：
• hdc uninstall package
• 获取所有应用
• hdc shell bm dump -a
• 
  

调试相关的命令

调试涉及以下命令：

• hilog 支持抓取log信息。
• 表17 命令说明
• 参数参数说明无无返回值返回值说明返回具体信息抓取的日志信息
• 抓取hilog日志：
• hdc hilog
• 清理hilog缓存日志：
• hdc shell "hilog -r"
• shell [command] 远程执行命令或进入交互命令环境。
• 表18 命令说明
• 参数参数说明command需要执行的单次命令返回值返回值说明返回具体信息shell后面执行命令的结果信息
• 使用方法：
• hdc shell
• jpid 获取可调试进程列表。
• 使用方法：
• hdc jpid

自动化相关命令
shell命令方式注入UI模拟操作

支持操作类型：点击 双击 长按 慢滑 快滑 拖拽 输入文字 KeyEvent。

示例代码1：执行点击事件。

 hdc shell uitest uiInput click 100 100
shell

示例代码2：执行双击事件。

 hdc shell uitest uiInput doubleClick 100 100
shell

示例代码3：执行长按事件。

 hdc shell uitest uiInput longClick 100 100
shell

示例代码4：执行快滑操作。

hdc shell uitest uiInput fling 10 10 200 200 500 
shell

示例代码5：执行慢滑操作。

hdc shell uitest uiInput swipe 10 10 200 200 500 
shell

示例代码6：执行拖拽操作。

hdc shell uitest uiInput drag 10 10 100 100 500 
shell

示例代码7：执行向左滑动操作。

hdc shell uitest uiInput dircFling 0 500
shell

示例代码8：执行向右滑动操作。

hdc shell uitest uiInput dircFling 1 600
shell

示例代码9：执行向上滑动操作。

hdc shell uitest uiInput dircFling 2 
shell

示例代码10：执行向下滑动操作。

hdc shell uitest uiInput dircFling 3
shell

示例代码11：执行输入框输入操作。

hdc shell uitest uiInput inputText 100 100 hello
shell

示例代码12：执行返回主页操作。

hdc shell uitest uiInput keyEvent Home
shell

示例代码13：执行返回上一步操作。

hdc shell uitest uiInput keyEvent Back
shell

示例代码14：执行组合键粘贴操作。

hdc shell uitest uiInput keyEvent 2072 2038
shell

常见问题

hdc连接不到设备

• 现象描述 执行 "hdc list targets"命令后结果为：[Empty]
• 解决方法
• 设备没有被识别： 在设备管理器中查看是否有hdc设备，在通用串行总线设备中会有“HDC Device”信息。如果没有，hdc无法连接。此时需要断开并重联PC和OpenHarmony设备之间的USB连接，或者烧写最新的镜像。
• hdc工作异常： 可以执行"hdc kill"或者"hdc start -r"杀掉hdc服务或者重启hdc服务，然后再执行hdc list targets查看是否已经可以获取设备信息。
• hdc与设备不匹配： 如果设备烧写的是最新镜像，hdc也需要使用最新版本。

hdc运行不了

• 现象描述 点击hdc.exe文件无法运行。
• 解决方法
• 运行环境异常： linux版本建议ubuntu 18.04以上 64位，其他相近版本也可；libc++.so引用错误请使用ldd/readelf等命令检查库引用 windows版本建议windows10 64位，如果低版本windows winusb库缺失，请使用zadig更新库。对于复合设备，需要使用zadig工具安装libusb-win32驱动。
• 如何运行hdc.exe： hdc.exe不需要安装，直接放到磁盘上就能使用，也可以添加到环境变量中。通过打开cmd执行hdc命令直接使用。

hdc client如何远程访问hdc server

• 使用场景
• 本地client指定远程server上的设备，执行hdc命令。
• 连接步骤
• 关闭本地sever：hdc kill
• -s [ip:]port -m 启动远程server：hdc -s severIP:8710 -m
• -s [ip:]port command 指定server执行指令：hdc -s severIP:8710 list targets