3 HDC调试

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

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

3.1 环境准备

本文档以 Window11 电脑和 RK 开发版为例进行说明

3.1.1 安装USB驱动

百度网盘链接：ShiMetaPi配套网盘资料 - 百度网盘，提取码：smcc

DriverAssitant 是 RK 开发板自带的 USB 驱动。

1） 解压资料包中的瑞芯微的USB驱动压缩包（DriverAssitant_v5.1.1）。

HDC

备注：

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

2） 解压压缩包后文件夹中点击驱动安装（DriverInstall.exe）即可。

3） 设备管理器查看驱动是否安装成功，成功将如下图所示，显示 “HDC Device”。

HDC

3.1.2 HDC工具下载

1） 下载资料包中的 HDC 工具，HDC文件夹内包含的文件如下图所示。

HDC

本文档将上述两个文件放入 D:\tools\HDC 路径下

HDC

备注：

工具路径：ShiMetaPi配套网盘资料>02-软件工具>Rockchip>OpenHarmony>HDC 工具

2） HDC路径环境配置：

HDC PATH环境配置如图所示：
我的电脑，右键选择属性，选择“高级系统设置 -> 环境设置 -> 系统环境变量中的 PATH 双击 -> 新建输入“D:\tools\HDC” -> 一路“确定”。

HDCHDCHDC

注意：

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

3.3 连接设备

1）M4-R1的USB-OTG默认已经是device模式。
2）电脑用USB线连接设备OTG口。
3）电脑上打开命令行工具，输入hdc list targets，连接成功可打印出设备，如下：

hdc list targets
d6290343394135353110d2d800002b00

4）输入 hdc shell，可以进入终端

HDC

3.4 常用命令

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

1）设备查询

	hdc list targets

2）remount

	hdc shell mount -o remount,rw /

3）启动APP

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

4）重启

	hdc shell reboot

5）安装APP

	hdc install -r 路径.hap

6）复制电脑文件到设备

	hdc file send "D:\D-backup\temp_work\xxx.hap" data/xxx.hap

7）复制设备文件到电脑(抓log)

	hdc file recv /data/log ./openharmony_log

8）查询应用信息

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

3.5 bn工具

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

具体详细介绍，见官方文档：bm工具 - OpenAtom OpenHarmony

3.6 aa工具

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

具体详细介绍，见官方文档：aa工具 - OpenAtom OpenHarmony