一、设备连接与管理
- 查看已连接的设备
显示当前连接的设备列表(设备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(按级别)快速定位问题。