鸿蒙（OpenHarmony/HarmonyOS）开发中常用的命令行工具及操作大全

一、设备连接与管理

• 查看已连接的设备

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

hdc list targets

• 连接设备

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

hdc target mount

• 重启设备

hdc reboot

• 进入设备 Shell

hdc shell

• 查看HDC版本

hdc -v

• 查看设备信息

hdc shell param get const.product.name 

• 点亮屏幕（唤醒）

hdc shell power-shell wakeup

二、应用包管理

• 安装应用

示例：安装企业级应用（需先配置设备权限）：
hdc install enterprise_app.hap

hdc install [HAP包路径]

• 卸载应用

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

hdc uninstall [包名]

• 查看已安装应用

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

hdc shell bm dump -a

• 强制覆盖安装

-r 表示覆盖安装（保留数据）。

hdc install -r [HAP包路径]

三、调试与日志

• 查看实时日志

输出设备实时日志（类似 Android 的 adb logcat）。

hdc hilog

• 按标签过滤日志

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

hdc hilog -T [标签]

• 按日志级别过滤

级别：D（Debug）、I（Info）、W（Warn）、E（Error）。

hdc hilog -L [级别]

• 清空日志缓存

hdc hilog -c

四、文件操作

• 推送文件到设备

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

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

• 从设备拉取文件

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

• 删除设备文件

hdc shell rm [文件路径]

五、系统配置

• 开启开发者模式

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

hdc shell param set const.product.developmentmode 1

• 允许安装企业级应用

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

hdc shell param set const.bms.allowenterprisebundle true

• 查看系统参数

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

hdc shell param get [参数名]

六、进程与性能

• 查看运行中的进程

hdc shell ps

• 查看 CPU 使用率

hdc shell top -n 1

• 终止进程

hdc shell kill [PID]

七、网络调试

• 查看设备 IP

hdc shell ifconfig

• 端口转发

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

八、应用签名相关

• 生成签名证书

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

• 查看证书信息

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

• 修改企业级签名字段

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

九、其他实用命令

• 屏幕截图

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

• 录屏（需设备支持）

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

• **查看设备信息

hdc shell param get | grep ro.product.model

注意事项

1、权限问题：

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

2、企业应用签名：

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

3、日志过滤技巧：

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