HDC使用常见命令

HDC（HarmonyOS Device Connector）是为开发人员提供的用于调试的命令行工具，通过该工具可以在windows/linux/mac系统上与真实设备进行交互。

使用HDC前，需要配置相关环境变量：

在此电脑 > 属性 > 高级系统设置 > 高级 > 环境变量中，添加HDC端口变量名为：HDC_SERVER_PORT，变量值可设置为任意未被占用的端口。环境变量配置完成后，关闭并重启DevEco Studio。

在此电脑 > 属性 > 高级系统设置 > 高级 > 环境变量 > 系统变量中，将SDK的toolchains完整路径添加到Path变量值中，具体路径信息以SDK实际配置路径为准。

常见命令：

Option	说明
-t [key] [command]	指定连接唯一标识的目标设备，标识可通过命令hdc list targets查询
help/-h	打印hdc帮助信息
version/-v	打印hdc版本信息
-l [level]	指定运行时日志等级，默认为LOG_INFO
checkserver	获取client-server版本
target mount	读写模式挂载系统分区（user不可用）
target boot	重启目标设备，查看目标列表可用list targets命令
smode [-r]	授予设备端hdc后台服务进程root权限，使用-r参数取消授权（user不可用）
kill [-r]	终止hdc服务进程，使用-r参数触发服务进程重新启动
start [-r]	启动hdc服务进程，使用-r参数触发服务进程重新启动
fport ls	列出全部转发端口转发任务
fport localnode remotenode	设置正向端口转发任务：监听“主机端口”，接收请求并进行转发，转发到“设备端口”
fport rm localnode remotenode	删除正向端口转发任务：取消指定的“主机端口”转发
rport remotenode localnode	设置反向端口转发任务：监听“设备端口”，接收请求并进行转发，转发到“主机端口”
rport rm remotenode localnode	删除反向端口转发任务：取消指定的“设备端口”转发
tmode usb	已连接设备切换为USB连接方式：设备端daemon进程重启，并首先选用USB连接方式
tmode port [port-number]	已连接设备切换为网络连接方式：设备端daemon进程重启，并优先使用网络方式连接设备，如果连接设备失败，再选择USB连接
tconn [IP]:[port] [-remove]	指定连接设备：通过“IP地址：端口号”来指定连接的设备，使用-remove参数断开连接
file send local remote	从本地发送文件至远端设备
file recv remote local	从远端设备发送文件至本地
install src	安装指定的应用文件(.hap .hsp)
uninstall packageName	卸载指定的应用包package包名
jpid	显示可调试应用列表
hilog [options]	打印设备端的日志信息，options表示hilog支持的参数，可通过hdc hilog -h查阅支持的参数列表
shell [command]	交互命令，command表示需要执行的单次命令，不同类型或版本的系统支持的command命令有所差异，可以通过hdc shell ls /system/bin查阅支持的命令列表