05-系统调试--HDC调试

1.1 前言

hdc(OpenHarmony Device Connector)是为开发人员提供的用于设备连接调试的命令行工具,该工具需支持部署在Windows/Linux/Mac等系统上与OpenHarmony设备(或模拟器)进行连接调试通信。

简言之,hdc是OpenHarmony提供的用于开发人员调试硬件、应用的命令行工具,用在电脑与开发板之间的交互。适用于OpenHarmony应用、硬件开发及测试人员,是每个开发人员的必备、入门工具。

1.2 环境准备

支持运行环境

本文以window11电脑和Rk开发板为例进行说明

安装USB驱动

DriverAssitant 是RK 开发板自带的 USB驱动。双击 DriverInstall.exe,选择驱动安装。

1) 百度网盘资料中下载瑞芯微的USB驱动压缩包(DriverAssitant_v5.1.1)
2) 解压压缩包后文件夹中点击驱动安装(DriverInstall.exe)

备注

驱动安装路径:ShiMetaPi配套网盘资料>02-软件工具>Rockchip>RKTools>windows>DriverAssitant_v5.1.1.zip

  1. 设备管理器查看驱动是否安装成功:

hdc2

2.hdc工具下载

1)百度网盘资料中下载HDC工具 链接:https://pan.baidu.com/s/1nD6d__hYqQhQKyXvVfKoJg 提取码:smcc

hdc3

备注

驱动安装路径:ShiMetaPi配套网盘资料>02-软件工具>OpenHarmony>HDC 工具

2)hdc路径环境配置:

hdc path环境配置如图所示:我的电脑,右键选择属性,选择“高级系统设置”→环境设置→系统环境变量中的 path双击→新建输入“D:toolsHDC”→一路“确定”

hdc4

hdc5

hdc6

小技巧

环境变量中的路径选择自己电脑中hdc存在的路径,不要带中文字符

1.3 连接设备

1)SC-3568HA的USB-OTG默认已经是device模式。

2)电脑用USB线连接设备OTG口。

3)电脑上打开命令行工具,输入`hdc list targets`,连接成功可打印出设备,如下:

hdc list targets
150100414a54443452069035fa308800

4)输入'hdc shell'可以进入终端

hdc8

1.4 常用命令

以下着重介绍些常用的HDC 指令,其他的可以自行通过搜索引擎查找

  1. 设备查询

hdc list targets
  1. remount

hdc shell mount -o remount,rw /
  1. 启动APP

hdc shell aa start -a MainAbility -b com.example.sampledemo
  1. 重启

hdc shell reboot
  1. 命令安装APP

hdc install -r 路径.hap
  1. 复制电脑文件到设备

hdc file send "D:\D-backup\temp_work\xxx.hap" data/xxx.hap
  1. 复制设备文件到电脑(抓log)

hdc file recv /data/log ./openharmony_log
  1. 查询应用信息

bm dump -n com.example.mydemo |grep system

1.5 bn 工具

Bundle Manager(包管理工具,简称bm)是实现应用安装、卸载、更新、查询等功能的工具,bm为开发者提供基本的应用安装包的调试能力,例如:安装应用,卸载应用,查询安装包信息等。

1.6 aa工具

Ability assistant(Ability助手,简称为aa),是实现应用及测试用例启动功能的工具,为开发者提供基本的应用调试和测试能力,例如启动应用组件、强制停止进程、打印应用组件相关信息等。