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

文章目录

一、设备连接与管理
二、应用包管理
三、调试与日志
四、文件操作
五、系统配置
六、进程与性能
七、网络调试
八、应用签名相关
九、其他实用命令
注意事项

一、设备连接与管理

查看已连接的设备

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

javascript 复制代码

hdc list targets

连接设备

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

javascript 复制代码

hdc target mount

重启设备

javascript 复制代码

hdc reboot

进入设备 Shell

javascript 复制代码

hdc shell

查看HDC版本

javascript 复制代码

hdc -v

查看设备信息

javascript 复制代码

hdc shell param get const.product.name

点亮屏幕（唤醒）

javascript 复制代码

hdc shell power-shell wakeup

二、应用包管理

安装应用

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

hdc install enterprise_app.hap

javascript 复制代码

hdc install [HAP包路径]

卸载应用

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

hdc uninstall com.example.app

javascript 复制代码

hdc uninstall [包名]

查看已安装应用

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

javascript 复制代码

hdc shell bm dump -a

强制覆盖安装

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

javascript 复制代码

hdc install -r [HAP包路径]

三、调试与日志

查看实时日志

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

javascript 复制代码

hdc hilog

按标签过滤日志

示例：过滤标签为 AppManager 的日志：

hdc hilog -T AppManager

javascript 复制代码

hdc hilog -T [标签]

按日志级别过滤

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

javascript 复制代码

hdc hilog -L [级别]

清空日志缓存

javascript 复制代码

hdc hilog -c

四、文件操作

推送文件到设备

示例：推送配置文件到设备：

hdc file send config.json /data/app/config.json

javascript 复制代码

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

从设备拉取文件

javascript 复制代码

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

删除设备文件

javascript 复制代码

hdc shell rm [文件路径]

五、系统配置

开启开发者模式

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

javascript 复制代码

hdc shell param set const.product.developmentmode 1

允许安装企业级应用

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

javascript 复制代码

hdc shell param set const.bms.allowenterprisebundle true

查看系统参数

示例：查看开发模式状态：

hdc shell param get const.product.developmentmode

javascript 复制代码

hdc shell param get [参数名]

六、进程与性能

查看运行中的进程

javascript 复制代码

hdc shell ps

查看 CPU 使用率

javascript 复制代码

hdc shell top -n 1

终止进程

javascript 复制代码

hdc shell kill [PID]

七、网络调试

查看设备 IP

javascript 复制代码

hdc shell ifconfig

端口转发

javascript 复制代码

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

八、应用签名相关

生成签名证书

javascript 复制代码

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

查看证书信息

javascript 复制代码

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

修改企业级签名字段

javascript 复制代码

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

九、其他实用命令

屏幕截图

javascript 复制代码

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

录屏（需设备支持）

javascript 复制代码

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

**查看设备信息

javascript 复制代码

hdc shell param get | grep ro.product.model

注意事项

1、权限问题：

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

2、企业应用签名：

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

3、日志过滤技巧：

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