鸿蒙（OpenHarmony/HarmonyOS）开发中常用的命令行工具及操作大全_鸿蒙系统指令代码大全

文章目录

• 一、设备连接与管理
• • 1、查看已连接的设备
  • 2、连接设备
  • 3、重启设备
  • 4、进入设备 Shell
  • 5、查看HDC版本
  • 6、查看设备信息
  • 7、点亮屏幕（唤醒）
• 二、应用包管理
• • 1、安装应用
  • 2、卸载应用
  • 3、查看已安装应用
  • 4、强制覆盖安装
• 三、调试与日志
• • 1、查看实时日志
  • 2、按标签过滤日志
  • 3、按日志级别过滤
  • 4、清空日志缓存
• 四、文件操作
• • 1、推送文件到设备
  • 2、从设备拉取文件
  • 3、删除设备文件
• 五、系统配置
• • 1、开启开发者模式
  • 2、允许安装企业级应用
  • 3、查看系统参数
• 六、进程与性能
• • 1、查看运行中的进程
  • 2、查看 CPU 使用率
  • 3、终止进程
• 七、网络调试
• • 1、查看设备 IP
  • 2、端口转发
• 八、应用签名相关
• • 1、生成签名证书*
  • 2、查看证书信息
  • 3、修改企业级签名字段
• 九、屏幕截图
• • 1、屏幕截图
  • 2、录屏（需设备支持）
  • 3、查看设备信息
• 注意事项
• 十、获取实际设备类型（default、tablet、phone...）

一、设备连接与管理

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.appC:\\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.pnghdc 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