一、设备连接与管理

1、查看已连接的设备

显示当前连接的设备列表(设备ID、状态)。

hdc list targets

2、连接设备

挂载设备文件系统(需要设备已开启开发者模式)

hdc target mount

3、重启设备

hdc reboot

4、进入设备 Shell

hdc shell

5、查看HDC版本

hdc -v

6、查看设备信息

hdc shell param get const.product.name 

7、点亮屏幕(唤醒)

hdc shell power-shell wakeup

二、应用包管理

1、安装应用

示例:安装企业级应用(需先配置设备权限):
hdc install enterprise_app.hap

hdc install [HAP包路径]

2、卸载应用

示例:卸载包名为 com.example.app 的应用:
hdc uninstall com.example.app

hdc uninstall [包名]

如果卸载失败,可以用下面方法

  • a)查询要删除的app包名
hdc shell ls /data/app/el1/bundle/public/com.example.app

在这里插入图片描述

  • b)强制删除并重启
C:\Users\Administrator>hdc shell rm -rf /data/app/el1/bundle/public/com.example.app

C:\Users\Administrator>hdc shell reboot

3、查看已安装应用

列出设备上所有已安装应用的信息。

hdc shell bm dump -a

4、强制覆盖安装

-r 表示覆盖安装(保留数据)。

hdc install -r [HAP包路径]

三、调试与日志

1、查看实时日志

输出设备实时日志(类似 Android 的 adb logcat)。

hdc hilog

2、按标签过滤日志

示例:过滤标签为 AppManager 的日志:
hdc hilog -T AppManager

hdc hilog -T [标签]

3、按日志级别过滤

级别:D(Debug)、I(Info)、W(Warn)、E(Error)。

hdc hilog -L [级别]

4、清空日志缓存

hdc hilog -c

四、文件操作

1、推送文件到设备

示例:推送配置文件到设备:
hdc file send config.json /data/app/config.json

hdc file send [本地文件路径] [设备目标路径]

2、从设备拉取文件

hdc file recv [设备文件路径] [本地保存路径]

3、删除设备文件

hdc shell rm [文件路径]

法二:hdc shell rm -f [文件路径]
-f 参数强制删除,避免提示确认。

五、系统配置

1、开启开发者模式

必须开启,否则无法安装调试应用。

hdc shell param set const.product.developmentmode 1

2、允许安装企业级应用

企业应用需配合特殊签名使用。

hdc shell param set const.bms.allowenterprisebundle true

3、查看系统参数

示例:查看开发模式状态:
hdc shell param get const.product.developmentmode

hdc shell param get [参数名]

六、进程与性能

1、查看运行中的进程

hdc shell ps

2、查看 CPU 使用率

hdc shell top -n 1

3、终止进程

hdc shell kill [PID]

七、网络调试

1、查看设备 IP

hdc shell ifconfig

2、端口转发

hdc fport tcp:本地端口 tcp:设备端口

八、应用签名相关

1、生成签名证书*

keytool -genkeypair -alias [别名] -keyalg RSA -keysize 2048 -validity 365 -keystore [证书路径]

2、查看证书信息

keytool -list -v -keystore [证书路径]

3、修改企业级签名字段

keytool -genkeypair ... -ext "app-distribution-type=enterprise_mdm"

九、屏幕截图

1、屏幕截图

hdc shell snapshot_display -f /data/screenshot.png
hdc file recv /data/screenshot.png ./screenshot.png

2、录屏(需设备支持)

hdc shell screenrecorder --time 10 --bit-rate 8000000 /data/screenrecord.mp4

3、查看设备信息

hdc shell param get | grep ro.product.model

注意事项

1、权限问题:

  • 部分命令需要设备开启开发者模式(const.product.developmentmode=1)。

2、企业应用签名:

  • 企业级应用需修改证书中的 app-distribution-type 字段为 enterprise_mdm。

3、日志过滤技巧:

  • 结合 hilog -T(按标签)和 -L(按级别)快速定位问题。

十、获取实际设备类型(default、tablet、phone…)

  • hdc shell param get const.product.devicetype
    在这里插入图片描述
Logo

社区规范:仅讨论OpenHarmony相关问题。

更多推荐