OpenHarmony实战：命令行工具hdc安装应用指南-Toy模板网

这篇具有很好参考价值的文章主要介绍了OpenHarmony实战：命令行工具hdc安装应用指南。希望对大家有所帮助。如果存在错误或未考虑完全的地方，请大家不吝赐教，您也可以点击"举报违法"按钮提交疑问。

一、工具概述

hdc（OpenHarmony Device Connector）是为开发人员提供的用于设备连接调试的命令行工具，该工具需支持部署在 Windows/Linux/Mac 等系统上与 OpenHarmony 设备（或模拟器）进行连接调试通信。
简言之，hdc 是 OpenHarmony 提供的用于开发人员调试硬件、应用的命令行工具，用在电脑与开发板之间的交互。
适用于 OpenHarmony 应用、硬件开发及测试人员,是每个开发人员的必备、入门工具。

二、环境准备

环境要求
本文以 window10 电脑和 Rk3568 开发板为例进行说明。linux 版本建议 ubuntu 18.04 以上 64 位，其他相近版本也可；libc++.so 引用错误请使用 ldd/readelf 等命令检查库引用 windows 版本建议 windows10 64 位，如果低版本 windows winusb 库缺失，请使用 zadig 更新库。
安装 USB 设备驱动安装
第一步，连接 PC 与开发板 USB 线 PC 与开发板通过 USB 调试线连接，开发板上运行开源系统主线版本。连接端口如蓝色线缆所示

第二步，安装 USB 驱动 DriverAssitant 是 RK3568 开发板自带的 USB 驱动。双击 DriverInstall.exe，选择驱动安装。

第三步，设备管理器查看驱动是否安装成功未连接 USB 先或者驱动未安装成功如图片左边所示，成功则如右边所示，会出现”hdc Device”。
hdc 工具下载

第一步，下载安装包

链接：http://ci.openharmony.cn/workbench/cicd/dailybuild/dailylist 查找“流水线名称”名称为 ohos-sdk-full, 或者 ohos-sdk-public，点击‘下载链接’，选择‘全量包’

第二步，解压缩任意一个选择红框中的文件第三步，拷贝至 D:\hdc_bin\目录下注意：无须双击安装
hdc 路径环境配置
hdc path 环境配置如图所示。我的电脑，右键选择属性，选择“高级系统设置”→ 高级 → 环境设置 → 系统环境变量中的 path→ 输入“D:\hdc_bin”→ 一路“确定”
至此，hdc 可以正常运行了
打开 cmd 窗口，执行 hdc shell 就进入命令交互界面。

三、hdc 功能列表

序号	命令	功能描述	成功输出
1	hdc -v	查看工具版本	Ver: 1.1.2a
2	hdc -h	查看工具帮助	OpenHarmony device connector(HDC) ...
3	hdc list targets	查看已连接设备	7001005458323933328a250efe593900
4	hdc list targets -v	查看连接设备详细信息	7001005458323933328a250efe593900 USB Connected localhost
5	hdc shell	进入命令行交互环境	#
6	hdc shell mount -o rw,remount	挂在系统目录	tmpfs on /dev type tmpfs (rw,seclabel,nosuid,relatime,size=990956k,nr_inodes=247739,mode=755)...
7	hdc file send d:\test.txt /data/	从 PC 拷入文件到开发板(往设备中推送文件)	FileTransfer finish, Size:xxx time:26ms rate:xxxkB/s
8	hdc file recv /data/test.txt c:\test.txt	从开发板拷出文件到 PC(从设备中拉取文件)	FileTransfer finish, Size:xxx time:51ms rate:xxxkB/s
9	hdc install D:\test.hap	安装 HAP 应用	[Info]App install path:D:\test.hap, queuesize:0, msg:install bundle successfully. AppMod finish
10	hdc install -r test.hap	重新安装 HAP 应用	[Info]App install path:D:\test.hap, queuesize:0, msg:install bundle successfully. AppMod finish
11	hdc uninstall com.example.ohtest	卸载已安装应用	[Info]App uninstall path:, queuesize:0, msg:uninstall bundle successfully. AppMod finish
12	hdc shell aa start -a com.example.ohtest.MainAbility -b com.example.ohtest	启动已安装应用 -a 后面是 Ability 的完整名字 -b 后面是 Bundle 的完整名字	start ability successfully.
13	hdc hilog	查看日志	08-05 19:45:29.912...
14	hdc target mount	重新挂载/vendor 和/system 分区为可读写	Mount finish
15	hdc start -r	重新启动 hdc 服务进程	None
16	hdc kill	终止 hdc 服务进程	Kill server finish
17	hdc target boot	重启设备	None
18	hdc shell hilog -w start	开始保存日志到文件	Persist task [jobid:1] start successfully
18	hdc shell hilog -w stop	开始保存日志到文件	Persist task [jobid:1] stop successfully
19	hdc tconn 192.168.0.27:10111	TCP 网络连接	None

四、hdc 常用命令讲解，未尽命令使用 hdc -h 或者 hdc --help 查看

Sn	Option	Description	Example
1	-t key	用于指定连接该指定设备识 Key	hdc -t *****(设备 id) shell
2	-s socket	用于指定服务监听的 socket 配置	hdc -s ip:port
3	-h/help -v/version	用于显示 hdc 相关的帮助、版本信息	None
4	list targets[-v]	显示所有已经连接的目标设备列表，-v 选项显示详细信息	hdc list targets
5	target mount	以读写模式挂载/vendor、/data 等分区，因为安全性问题，需要挂在根目录或者/system 分区请单独使用 'hdc_std shell mount -o rw,remount /'等命令	hdc target mount
6	smode [off]	授予后台服务进程 root 权限，使用 off 参数取消授权	hdc smode
7	kill [-r]	终止 hdc 服务进程, -r 选项会触发再次重启 hdc server	hdc kill
8	start [-r]	启动 hdc 服务进程, -r 选项会触发重启 hdc server	hdc start
9	tconn host[:port][-remove]	通过【ip 地址：端口号】来指定连接的设备使用 TCP 模式连接设备，需在 USB 模式工作下使用 tmode tcp 切换至 TCP 工作模式，或者在系统属性值中设置 persist.hdc.mode 属性值为 tcp，如果需要监听固定 TCP 端口需要再设置 persist.hdc.port 的端口号，反之则 TCP 监听端口随机	hdc tconn 192.168.0.100:10178
10	tmode usb	执行后设备端对应 daemon 进程重启，并首先选用 usb 连接方式	None
11	tmode port port-number	执行后设备端对应 daemon 进程重启，并优先使用网络方式连接设备，如果连接设备再选择 usb 连接	None
12	file send local remote	从 host 端发送文件至设备端	hdc file send E:\a.txt /data/local/tmp/a.txt
13	file recv [-a] remote local	从设备端拉出文件至本地 host 端	hdc file recv /data/local/tmp/a.txt ./a.txt
14	install [-r/-d/-g] package	安装 OpenHarmony package	hdc install E:\***.hap
15	uninstall [-k] package	卸载 OpenHarmony 应用	None
16	hilog	支持查看抓取 hilog 调试信息	hdc hilog
17	shell [command]	远程执行命令或进入交互命令环境	hdc shell

五、常见问题处理

hdc list targets 查找不到设备
第一步，检查 PC 上设备管理器中 USB 驱动是否正常，如果没有正常显示，卸载之前安装的驱动，然后重装驱动，或者更换 USB 线；
第二步，检查 PC 上的 hdc 工具版本是否为最新，版本 Ver: 1.1.2a 及以上；
第三步，装完驱动后，重启 PC 和开发板；
第四步，重启 PC 本地 hdc 服务：

hdc start -r
第五步，杀掉本地服务并重启 PC 侧 hdc 服务：
hdc kill -r
第六步，如果不行，更换开发板。

从 PC 拷贝文件到开发板失败

hdc file send d:\ohtest.hap /system/
[Fail]Error opening file: read-only file system, path:/system//ohtest.hap
第一步，重新挂在目标目录
hdc shell mount -o rw,remount
第二步，可能目标目录只读，更换其他可读写目录尝试一下
hdc file send d:\ohtest.hap /data/
FileTransfer finish, Size:xxx time:86ms rate:xxxkB/s

从开发板拷贝文件到 PC 失败

hdc file recv /data/tmp/entry-debug-standard-ark-signed.hap d:
[Fail]Error opening file: operation not permitted, path:d:\entry-debug-standard-ark-signed.hap
可能是磁盘根目录没有权限，建议建一个文件夹，然后拷贝到文件夹下
hdc file recv /data/tmp/entry-debug-standard-ark-signed.hap d:\recv
FileTransfer finish, Size:71030 time:60ms rate:1183.83kB/s

六、补充

源代码目录 .\developtools\hdc，非必要不用编译。文中涉及的 hdc 工具和 USB 驱动从附件下载。
hdc_bin: hdc 工具包
DriverAssitant: RK3568 配套的 USB 驱动
Cmder.exe: 代替系统 cmd 控制台程序，可以分割多个窗口同时监听、交互感兴趣的内容。十分好用，因为安装包较大建议自行下载。

七、总结

OpenHarmony 命令行工具 hdc 安装、应用指南详细阐述了 hdc 工具下载、安装、路径的环境配置和 USB 驱动安装。接下来完整给出了 19 条 hdc 命令用法及正确输出示意。最后列出典型的三种错误处理。

最后

有很多小伙伴不知道学习哪些鸿蒙开发技术？不知道需要重点掌握哪些鸿蒙应用开发知识点？而且学习时频繁踩坑，最终浪费大量时间。所以有一份实用的鸿蒙（HarmonyOS NEXT）资料用来跟着学习是非常有必要的。

这份鸿蒙（HarmonyOS NEXT）资料包含了鸿蒙开发必掌握的核心知识要点，内容包含了（ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、Harmony南向开发、鸿蒙项目实战等等）鸿蒙（HarmonyOS NEXT）技术知识点。

希望这一份鸿蒙学习资料能够给大家带来帮助，有需要的小伙伴自行领取，限时开源，先到先得~无套路领取！！

获取这份完整版高清学习路线，请点击→纯血版全套鸿蒙HarmonyOS学习资料