hdc（OpenHarmony Device Connector）是为开发人员提供的用于设备连接调试的命令行工具，该工具需支持部署在 Windows/Linux/Mac 等系统上与 OpenHarmony 设备（或模拟器）进行连接调试通信。简单来讲，hdc 是 OpenHarmony 提供的用于开发人员调试硬件、应用的命令行工具，用在电脑与开发板之间的交互。
hdc适用于 OpenHarmony 应用、硬件开发及测试人员，是每个开发人员的必备、入门工具。
官方文档：文档中心
参考资料：【全网最全】鸿蒙 HDC 命令合集 (awesome-hdc)_鸿蒙hdc-CSDN博客
一、使用方法
在使用hdc前，请在设备上开启usb调试功能，用usb线连接设备和PC。
1.基本语法
单个设备连接
hdc <command>
多个设备连接
hdc -t <connectKey> <command>
-t: 连接指定的目标设备，连接一台设备时为可选参数，连接多台设备时为必选参数。
connectKey： 为已经连接设备的唯一标识符。可使用hdc list targets 命令获得。
例如
这里获取到的connectKey为880103534c4433324747a35fd1a01b00
则可以使用如下命令
2.参数讲解
上面的命令中我们讲解了-t的意义，这里讲解一下所有的参数的意思。
| 参数 | 说明 |
|---|---|
| -t | 连接指定的目标设备，连接一台设备时为可选参数，连接多台设备时为必选参数。 |
| -l | 可选参数，指定运行时日志等级，范围为数字0-6，默认为3（LOG_INFO）。 |
| -s | 可选参数，指定客户端连接服务端时，服务进程的网络监听参数，格式为ip:port。 |
| -p | 可选参数，绕过对服务进程的查询步骤，用于快速执行客户端命令。 |
| -m | 可选参数，使用前台启动模式启动服务进程 |
二、所有命令
| list targets | 查询已连接的所有目标设备。 |
| wait | 等待设备正常连接。 |
| tmode port | 打开设备网络连接通道。 |
| tmode port close | 关闭设备网络连接通道。 |
| tconn | 指定连接设备：通过“IP地址：端口号”来指定连接的设备。 |
| shell | 在设备侧执行单次命令。 |
| install | 安装指定的应用文件。 |
| uninstall | 卸载指定的应用包。 |
| file send | 从本地发送文件至远端设备。 |
| file recv | 从远端设备发送文件至本地。 |
| fport ls | 列出全部转发端口转发任务。 |
| fport | 设置正向端口转发任务：监听“主机端口”，接收请求并进行转发， 转发到“设备端口”。 |
| rport | 设置反向端口转发任务：监听“设备端口”，接收请求并进行转发，转发到“主机端口”。 |
| fport rm | 删除指定的端口转发任务。 |
| start | 启动hdc服务进程。 |
| kill | 终止hdc服务进程。 |
| hilog | 打印设备端的日志信息。 |
| jpid | 显示设备上所有开启了JDWP调试协议的应用的PID。 |
| track-jpid | 实时显示设备上开启了JDWP调试协议的应用的PID和应用名。 |
| target boot | 重启目标设备。 |
| keygen | 生成一个新的秘钥对。 |
| version | 打印hdc版本信息，也可使用hdc -v打印版本信息。 |
| checkserver | 获取客户进程与服务进程版本信息。 |
三、使用示例
1.查询已连接的所有目标设备
hdc list targets2.发送文件到开发板
hdc file send 文件地址 发送目标地址3.进入shell
hdc shell4.卸载应用
hdc app uninstall 5.查看应用列表
hdc shell bm dump -a6.设置永不息屏
hdc shell power-shell setmode 602