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,选择驱动安装。
备注
驱动安装路径:ShiMetaPi配套网盘资料>02-软件工具>Rockchip>RKTools>windows>DriverAssitant_v5.1.1.zip
设备管理器查看驱动是否安装成功:
2.hdc工具下载
1)百度网盘资料中下载HDC工具 链接:https://pan.baidu.com/s/1nD6d__hYqQhQKyXvVfKoJg 提取码:smcc
备注
驱动安装路径:ShiMetaPi配套网盘资料>02-软件工具>OpenHarmony>HDC 工具
2)hdc路径环境配置:
hdc path环境配置如图所示:我的电脑,右键选择属性,选择“高级系统设置”→环境设置→系统环境变量中的 path双击→新建输入“D:toolsHDC”→一路“确定”
小技巧
环境变量中的路径选择自己电脑中hdc存在的路径,不要带中文字符
1.3 连接设备
1)SC-3568HA的USB-OTG默认已经是device模式。
2)电脑用USB线连接设备OTG口。
3)电脑上打开命令行工具,输入`hdc list targets`,连接成功可打印出设备,如下:
hdc list targets
150100414a54443452069035fa308800
4)输入'hdc shell'可以进入终端
1.4 常用命令
以下着重介绍些常用的HDC 指令,其他的可以自行通过搜索引擎查找
设备查询
hdc list targets
remount
hdc shell mount -o remount,rw /
启动APP
hdc shell aa start -a MainAbility -b com.example.sampledemo
重启
hdc shell reboot
命令安装APP
hdc install -r 路径.hap
复制电脑文件到设备
hdc file send "D:\D-backup\temp_work\xxx.hap" data/xxx.hap
复制设备文件到电脑(抓log)
hdc file recv /data/log ./openharmony_log
查询应用信息
bm dump -n com.example.mydemo |grep system
1.5 bn 工具
Bundle Manager(包管理工具,简称bm)是实现应用安装、卸载、更新、查询等功能的工具,bm为开发者提供基本的应用安装包的调试能力,例如:安装应用,卸载应用,查询安装包信息等。
1.6 aa工具
Ability assistant(Ability助手,简称为aa),是实现应用及测试用例启动功能的工具,为开发者提供基本的应用调试和测试能力,例如启动应用组件、强制停止进程、打印应用组件相关信息等。