OpenHarmony 开源鸿蒙北向开发——hdc工具使用及常用命令（持续更新）

 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 targets

2.发送文件到开发板

hdc file send 文件地址 发送目标地址

3.进入shell

hdc shell

4.卸载应用

hdc app uninstall 

5.查看应用列表

hdc shell bm dump -a

6.设置永不息屏

hdc shell power-shell setmode 602