当前位置:   article > 正文

OpenHarmony命令行工具hdc_std简介

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
  • 1
  • 2
  • 1
  • 2

查看工具帮助

D:\>hdc_std -h
  • 1
  • 1

查看已连接设备

D:\>hdc_std list targets
15010038475446345206a332927cb7cd
  • 1
  • 2
  • 1
  • 2

查看连接设备详细信息

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

进入命令行交互环境

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

从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
  • 1
  • 2
  • 1
  • 2

从开发板拷出文件到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
  • 1
  • 2
  • 1
  • 2

安装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
  • 1
  • 2
  • 3
  • 1
  • 2
  • 3

重新安装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
  • 1
  • 2
  • 3
  • 1
  • 2
  • 3

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

卸载已安装应用

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

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

启动已安装应用

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

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

查看日志

D:\>hdc_std hilog
  • 1
  • 1

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

D:\>hdc_std target mount
Mount finish
  • 1
  • 2
  • 1
  • 2

重新启动hdc服务进程

D:\>hdc_std start -r
  • 1
  • 1

终止hdc服务进程

D:\>hdc_std kill
Kill server finish
  • 1
  • 2
  • 1
  • 2

重启设备

D:\>hdc_std target boot
  • 1
  • 1

常见问题:

1.hdc_std list targets 查找不到设备

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

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

PC上执行,

D:\>hdc_std -v
Ver: 1.1.1k
  • 1
  • 2
  • 1
  • 2

开发板上执行,

# hdcd -v
Ver: 1.1.1k
  • 1
  • 2
  • 1
  • 2

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

  • 尝试重启PC本地hdc服务
D:\>hdc_std start -r
  • 1
  • 1
  • 杀掉本地服务并重启
D:\>hdc_std kill -r
  • 1
  • 1

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
  • 1
  • 2
  • 1
  • 2

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

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

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
  • 1
  • 2
  • 1
  • 2

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

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
  • 1
  • 2
  • 1
  • 2
声明:本文内容由网友自发贡献,不代表【wpsshop博客】立场,版权归原作者所有,本站不承担相应法律责任。如您发现有侵权的内容,请联系我们。转载请注明出处:https://www.wpsshop.cn/w/IT小白/article/detail/294218
推荐阅读
相关标签
  

闽ICP备14008679号