网站导航
> 文档中心 > OpenHarmony命令行工具hdc_std简介

OpenHarmony命令行工具hdc_std简介

网友: 文档中心 2022-10-17 11:33:15

工具简介：

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 -vVer: 1.1.1k

查看工具帮助

D:\>hdc_std -h

查看已连接设备

D:\>hdc_std list targets15010038475446345206a332927cb7cd

查看连接设备详细信息

D:\>hdc_std list targets -v15010038475446345206a332927cb7cd  USB     Connectedlocalhost

进入命令行交互环境

D:\>hdc_std shell# lsbin     data  etc   lib  proc  system   vendorconfig  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.hapFileTransfer 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.ohhelloworldstart ability successfully.

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

查看日志

D:\>hdc_std hilog

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

D:\>hdc_std target mountMount finish

重新启动hdc服务进程

D:\>hdc_std start -r

终止hdc服务进程

D:\>hdc_std killKill server finish

重启设备

D:\>hdc_std target boot

常见问题：

1.hdc_std list targets 查找不到设备

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

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

PC上执行，

D:\>hdc_std -vVer: 1.1.1k

开发板上执行，

# hdcd -vVer: 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:\recvFileTransfer finish, Size:71030 time:60ms rate:1183.83kB/s
网络标签：

相关问题