HarmonyOS-hdc远程网络方式连接设备
hdc工具使用手册
1 hdc简介
hdc（OpenHarmony Device Connector）是为开发人员提供的用于设备连接调试的命令行工具，pc端开发机使用命令行工具hdc，该工具需支持部署在Windows/Linux/Mac等系统上与OpenHarmony设备（或模拟器）进行连接调试通信。PC端hdc工具需要针对以上开发机操作系统平台分别发布相应的版本，设备端hdc daemon需跟随设备镜像发布包括对模拟器进行支持。hdc组成关系图如下图所示：
PC与设备侧，可以通过网络连接，也可以通过USB线连接。
2 连接设置
hdc主从设备之间的连接可以通过USB和网络的方式进行连接。
2.1 USB方式
2.1.1 windows环境下
windows下，连接usb线，查看设备管理器。如果能看到HDC Device的设备，说明设备识别正常，可以在命令行界面中输入HDC相关命令进行交互了。
2.1.2 linux环境下
-
（1）linux下需要添加usb设备权限，连接usb线，执行lsusb命令，能识别到Phytium “HDC Device”的设备,说明枚举正常。打开cmd窗口，执行 hdc shell 就进入了命令交互界面。
-
（2）运行HDC 命令报错问题解决
当执行hdc命令，提示[Fail] ExecuteCommnand need connect-key的错误时，解决方法为：编辑规则脚本：$ sudo vi /etc/udev/rules.d/90-myusb.rules添加内容: SUBSYSTEM=="usb", ATTR{idVendor}=="1db7",ATTR{idProduct}=="dc27", MODE="0666"重启电脑或重新加载udev规则:$ sudo udevadm control --reload
2.2 网络方式
如果使用网络方式，从机设备即Openharmony设备启动后需要优先开启hdc配置：
-
5.0 release版本之前的hdc配置
配置hdc模式和端口 $ param set persist.hdc.mode tcp #设置hdc以tcp的方式连接 $ param set persist.hdc.port 8710 #port也可是其他的端口号重启hdc服务 $ service_control stop hdcd #关闭hdc服务 $ service_control start hdcd #开启hdc服务查看hdc状态 $ param get | grep hdc -
5.0 release版本及以后的hdc配置
配置hdc模式和端口 $ param set persist.hdc.mode tcp #设置hdc以tcp的方式连接 $ param set persist.hdc.port 8710 #port也可是其他的端口号5.0release新增配置，必须设置： $ param set persist.hdc.mode.tcp enable $ param set persist.hdc.root 1 $ param set const.security.developermode.state true #开启开发者模式重启hdc服务 $ service_control stop hdcd #关闭hdc服务 $ service_control start hdcd #开启hdc服务查看hdc状态 $ param get | grep hdc完成上述配置后，在主机工作台下执行以下命令连接openharmony设备，确保主机工作台ip和openharmony的ip在同一网段下，建议使用同一路由器自动分配ip。
$ hdc tconn ip:port连接成功提示 Connect OK。
3 常用的hdc命令
连接从机设备：
$ hdc tconn ip:port查看设备连接信息:
$ hdc list targets -v 往设备中推送文件:
$ hdc target mount
$ hdc shell mount -0 rw,remount /
$ hdc file send E:\a.txt /data/local/tmp/a.txt 从设备中拉取文件：
$ hdc file recv /data/local/tmp/a.txt ./a.txt安装应用：
$ hdc install -r E:\***.hap查看日志：
$ hdc hilog进入命令行交互模式：
$ hdc shell