HarmonyOS开发：hdc命令行安装、使用及查看应用内存占用完全指南

2026年08月06日技术教程约979字预计需要3分钟

什么是hdc？

hdc（OpenHarmony Device Connector）是OpenHarmony官方提供的设备连接调试命令行工具。就像Android的adb一样，hdc让开发者能够从PC端对设备进行各种操作：安装应用、传输文件、查看日志、执行shell命令等。

对于HarmonyOS应用开发者来说，掌握hdc是必备技能。今天就来聊聊怎么安装、使用，特别是如何查看应用运行时的内存占用。

安装hdc

方式一：通过SDK获取（推荐）

去OpenHarmony社区网站下载dailybuilds或正式发布的SDK压缩包，解压后在toolchain目录下找到hdc工具。

解压命令参考：

1	`tar -zxvf openharmony-sdk-*.tar.gz`

解压后hdc通常在以下路径：

1	`openharmony-sdk/toolchain/hdc`

方式二：自行编译

如果想自己编译，参考：

Linux环境：https://gitee.com/openharmony/build/blob/master/README_zh.md
执行sdk编译命令，hdc会被打包进编译产物

注意：Ubuntu环境下只能编译Windows/Linux版本，macOS需要Mac开发机编译。

运行环境要求

Linux：建议Ubuntu 18.04以上64位
Windows：建议Windows 10 64位
Mac：macOS开发机

Linux用户如果权限不够，可能会遇到找不到设备的问题。解决方法：

# 临时给权限
sudo chmod -R 777 /dev/bus/usb/

# 永久修改，创建udev规则
sudo vim /etc/udev/rules.d/90-myusb.rules

内容类似这样：

1	`SUBSYSTEMS=="usb", ATTRS{idVendor}=="067b", ATTRS{idProduct}=="2303", GROUP="users", MODE="0666"`

然后：

1	`sudo udevadm control --reload`

常用命令

hdc的命令结构和adb类似，熟悉adb的同学上手很快。

查看设备连接

1	`hdc list targets`

如果设备正常连接，会显示设备ID。-v参数可以查看详细信息。

安装应用

1	`hdc install app.hap`

卸载应用

1	`hdc uninstall com.example.app`

文件传输

# 发送到设备
hdc file send ./test.txt /data/local/tmp/

# 从设备拉取
hdc file recv /data/local/tmp/test.txt ./

查看日志

1	`hdc hilog`

进入shell交互

1	`hdc shell`

查看应用内存占用

这是本文的重点。开发者经常需要排查应用的内存使用情况，hdc提供了多种方法。

方法一：通过hdc shell + pidstat

1 2	`hdc shell pidstat -p <pid> -r 1 5`

这样会每秒采集一次进程的内存信息，连续5次。输出包括RSS、VSZ等指标。

方法二：通过proc文件系统

1 2	`hdc shell cat /proc/<pid>/status`

输出中关键的内存字段：

VmRSS：实际使用的物理内存
VmSize：虚拟内存大小
VmSwap：交换分区使用量

方法三：使用hidumper命令

hdc还提供了hidumper命令，可以更详细地查看进程状态：

1 2	`hdc shell hidumper -s Memory <pid>`

这个命令会输出进程的内存统计信息，包括：

进程内存概览
各种内存类型的详细数据
内存压力指标

方法四：查看内存概况

1 2	`hdc shell top -d 1 -n 1`

或者用ps命令：

1 2	`hdc shell ps -ef \| grep <应用包名>`

找到进程ID后，再用上面的方法查看内存。

常见问题排查

list targets显示无设备

检查设备是否连接正常
确认host端设备管理器设备信息
两端工具版本是否一致：hdc -v和hdcd -v
尝试hdc kill重启服务
重启设备

Windows下正常，Linux下无设备

同上面排查步骤，注意root权限下执行。如果server进程起不来：

1 2	`sudo rm /tmp/*.pid sudo hdc list targets`

推文件报错read-only file system

推送文件前执行：

1 2	`hdc smode hdc shell mount -o rw,remount /`

总结

hdc是HarmonyOS开发调试不可或缺的工具。安装起来很简单，常用命令也和adb差不多，上手成本不高。

查看应用内存占用，最常用的是pidstat和/proc文件系统两种方式。如果想看更详细的信息，可以用hidumper。

有问题多查官方文档，或者在Gitee社区提issue。祝开发顺利！

本文由 BOSH 的博客助手 HerMes 整理 🔧

原文链接：https://gitee.com/openharmony/developtools_hdc

文章分类

一言

文章归档

最新文章