OpenHarmony命令行工具hdc_std简介 原创 精华

春节不停更，此文正在参加「星光计划-春节更帖活动」

工具简介：

hdc，全称 HarmonyOS Device Connector，是HarmonyOS提供的方便开发人员调试的命令行工具，使用该工具可以在个人电脑与设备或模拟器之间进行交互通讯。

hdc_std，与hdc相似，但它是OpenHarmony提供的用于开发人员调试的命令行工具，专门用在个人电脑与开发板之间的交互，并且这个开发板是需要运行OpenHarmony标准版（standard）系统的，所以在hdc后面加了std后缀以示区分。

简言之，手机上调试用的是hdc，开发板上调试用的是hdc_std，一个不开源，一个开源。

环境准备：

以window10电脑和HI3516DV300开发板为例。
PC上安装了DevEco Studio 3.0版本，安装过程中根据要求自动安装了OpenHarmonySDK。
PC与开发板通过usb调试线连接，开发板上运行OpenHarmony3.0标准版系统。
正常情况，应该打开cmd窗口就可以运行hdc_std命令了，如果找不到，在系统环境变量path中添加hdc_std所在路径，例如，作者的hdc_std工具所在目录为
C:\Users\username\AppData\Local\OpenHarmony\Sdk\toolchains 。

命令介绍：

查看工具版本

D:\>hdc_std -v
Ver: 1.1.1k

查看工具帮助

D:\>hdc_std -h

查看已连接设备

D:\>hdc_std list targets
15010038475446345206a332927cb7cd

查看连接设备详细信息

D:\>hdc_std list targets -v
15010038475446345206a332927cb7cd                USB     Connected       localhost

进入命令行交互环境

D:\>hdc_std shell
# ls
bin     data  etc   lib         proc  system   vendor
config  dev   init  lost+found  sys   updater

从PC拷入文件到开发板

D:\>hdc_std file send d:\entry-debug-standard-ark-signed.hap /data/tmp/
FileTransfer finish, Size:71030 time:26ms rate:2731.92kB/s

从开发板拷出文件到PC

E:\>hdc_std file recv  /data/tmp/entry-debug-standard-ark-signed.hap d:\recv\entry-debug-standard-ark-signed.hap
FileTransfer finish, Size:71030 time:51ms rate:1392.75kB/s

安装HAP应用

D:\>hdc_std install entry-debug-standard-ark-signed.hap
[Info]App install path:D:\entry-debug-standard-ark-signed.hap, queuesize:0, msg:install bundle successfully.
AppMod finish

重新安装HAP应用

D:\>hdc_std install -r entry-debug-standard-ark-signed.hap
[Info]App install path:D:\entry-debug-standard-ark-signed.hap, queuesize:0, msg:install bundle successfully.
AppMod finish

通过install -r执行重新安装，与卸载再安装效果一样。

卸载已安装应用

D:\>hdc_std uninstall com.example.ohhelloworld
[Info]App uninstall path:, queuesize:0, msg:uninstall bundle successfully.
AppMod finish

uninstall 后面跟的是要卸载的应用的包名。

启动已安装应用

D:\>hdc_std shell aa start -a com.example.ohhelloworld.MainAbility -b com.example.ohhelloworld
start ability successfully.

-a 后面是Ability的完整名字
-b 后面是Bundle的完整名字

查看日志

D:\>hdc_std hilog

重新挂载/vendor和/system分区为可读写

D:\>hdc_std target mount
Mount finish

重新启动hdc服务进程

D:\>hdc_std start -r

终止hdc服务进程

D:\>hdc_std kill
Kill server finish

重启设备

D:\>hdc_std target boot

常见问题：

1.hdc_std list targets 查找不到设备

• 检查PC上设备管理器中usb驱动是否正常，如果没有正常显示，可能是PC环境问题，或者usb线路连接问题。

• 检查PC上的hdc_std工具版本和开发板上hdcd版本是否一致。

PC上执行，

D:\>hdc_std -v
Ver: 1.1.1k

开发板上执行，

# hdcd -v
Ver: 1.1.1k

如果版本不一致，建议更新较低版本一端软件为较新版本。

• 尝试重启PC本地hdc服务

D:\>hdc_std start -r

• 杀掉本地服务并重启

D:\>hdc_std kill -r

2.从PC拷入文件到开发板失败

D:\>hdc_std file send d:\entry-debug-standard-ark-signed.hap /system/
[Fail]Error opening file: read-only file system, path:/system//entry-debug-standard-ark-signed.hap

可能目标目录只读，更换其他可读写目录尝试一下

D:\>hdc_std file send d:\entry-debug-standard-ark-signed.hap /data/
FileTransfer finish, Size:71030 time:86ms rate:825.93kB/s

3.从开发板拷出文件到PC失败

D:\>hdc_std 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

可能是磁盘根目录没有权限，建议建一个文件夹，然后拷贝到文件夹下

D:\>hdc_std file recv  /data/tmp/entry-debug-standard-ark-signed.hap d:\recv
FileTransfer finish, Size:71030 time:60ms rate:1183.83kB/s