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

发布于:2025-02-27 ⋅ 阅读:(11) ⋅ 点赞:(0)

一、设备连接与管理

  • 查看已连接的设备

显示当前连接的设备列表(设备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(按级别)快速定位问题。

网站公告

今日签到

点亮在社区的每一天
去签到