目录

一、HDC 是什么？

二、准备工作

三、基本使用方法详解

（一）设备连接管理

（二）执行交互命令

（三）应用管理

（四）文件传输

（五）端口转发

（六）服务进程管理

（七）设备操作

（八）安全相关命令

（九）查询版本号

四、实战案例展示

案例一：快速安装应用进行测试

案例二：通过端口转发进行网络调试

五、常见问题及解决方法

六、总结与展望

一、HDC 是什么？

HDC，即 HarmonyOS Device Connector，是鸿蒙系统为开发者提供的一款强大的命令行调试工具。它的出现，极大地便利了鸿蒙设备与开发环境之间的交互，堪称鸿蒙开发者手中的一把 “瑞士军刀”。

对于熟悉安卓开发的小伙伴来说，HDC 就像是安卓 ADB（Android Debug Bridge）工具的 “同门兄弟”。ADB 作为安卓开发中广泛使用的调试工具，能实现设备连接、应用安装调试、文件传输等诸多功能。而 HDC 在鸿蒙开发领域，同样肩负着类似的使命，并且针对鸿蒙系统的特性进行了优化和拓展。

想象一下，你是一位鸿蒙应用开发者，当你辛苦编写完一段代码，满心期待着在设备上进行测试时，HDC 就能大显身手。它可以帮助你快速将应用安装到鸿蒙设备上，实时查看设备的运行状态和日志信息，还能方便地在设备和开发主机之间传输文件。有了 HDC，开发过程中的调试工作变得更加高效，你能更快地发现并解决问题，让你的应用开发之路更加顺畅。

二、准备工作

在开启 HDC 的探索之旅前，我们得先做好准备工作，就像踏上一场冒险前，要备齐装备一样。获取 HDC 工具是首要任务，通常我们可以通过 OpenHarmony sdk 来获取它 ，它就静静地待在 sdk 的 toolchains 目录下，等待我们将它 “唤醒” 使用。比如在 Windows 系统中，获取 Windows 的 sdk 后，把 hdc.exe 放到磁盘某个位置，就初步具备了使用条件。

接下来是更为关键的环境配置环节，不同操作系统的配置方式各有特点：

Windows 系统：这是许多开发者常用的系统。首先，找到 “此电脑”，右键选择 “属性”，接着点击 “高级系统设置”，在弹出的窗口中找到 “高级” 选项卡，点击下方的 “环境变量” 按钮。在系统变量中，找到 “Path” 变量，点击 “编辑”。然后，点击 “新建”，将存放 hdc.exe 文件的目录路径粘贴进去。比如，你的 hdc.exe 存放在 “D:\hdc_tool” 目录下，就把 “D:\hdc_tool” 添加进去。完成后一路点击 “确定” 保存设置。这一步就像是在电脑的 “资源地图” 上，为 HDC 工具标记出清晰的位置，方便系统随时找到它。

Linux 系统：对于习惯 Linux 的开发者来说，配置过程充满了命令行的魅力。以常用的 Ubuntu 系统为例，打开终端，输入命令 “sudo nano ~/.bashrc”，这会打开.bashrc 文件。在文件末尾添加两行代码：“export HDC_HOME=/path/to/hdc”（这里的 “/path/to/hdc” 要替换为你实际存放 HDC 工具的路径）以及 “export PATH=\(PATH:\)HDC_HOME/bin” 。添加完成后，按下 “Ctrl + X”，再按 “Y”，最后按 “Enter” 保存并退出。之后，在终端输入 “source ~/.bashrc” 使配置生效。这种通过命令行直接编辑配置文件的方式，高效且充满技术感，就像是在系统的底层为 HDC 工具铺设了一条专属通道。

Mac 系统：Mac 系统的配置也不复杂。打开终端，通过执行 “echo \(SHELL”命令查看当前使用的shell类型。如果输出是“/bin/bash”，则编辑.bash_profile文件，输入“vi ~/.bash_profile”；如果输出是“/bin/zsh”，则编辑.zshrc文件，输入“vi ~/.zshrc” 。进入编辑模式后，添加“export HDC_SERVER_PORT=7035”（设置HDC服务器端口，可根据需求更改） ，以及添加SDK路径到PATH，例如“export PATH=\)PATH:/Users/yourusername/HarmonyOS/sdk/toolchains”（替换为你的实际路径） 。保存并退出编辑模式，使用 “source” 命令使配置生效。在 Mac 系统上完成这些配置，就如同为 HDC 工具在 Mac 的生态环境中找到了合适的栖息之所，让它能够顺畅运行。

完成上述环境配置后，我们可以在命令行中输入 “hdc -v” 来验证是否配置成功。如果成功，将会显示 HDC 的版本信息，这就像是收到了 HDC 的 “报到确认”，告诉我们一切准备就绪，可以开启后续的精彩操作啦。

三、基本使用方法详解

（一）设备连接管理

设备连接管理是使用 HDC 的基础，它就像是搭建起了一座沟通开发主机与鸿蒙设备的桥梁。在这个环节中，我们有一系列实用的命令可以使用。

查询设备列表：执行 “hdc list targets” 命令，就可以查看当前连接的所有设备列表。如果添加 “-v” 选项，如 “hdc list targets -v” ，还能获取设备的详细信息，包括设备的连接方式（是 USB 连接还是 TCP 连接）、连接状态等。这就好比我们在查看一个设备集合，能清楚地知道每个设备的 “身份” 和连接情况。例如，执行该命令后，可能会显示类似 “127.0.0.1:5555 TCP Connected localhost” 这样的信息，表明这是一个通过 TCP 连接的设备，连接状态为已连接，地址是 127.0.0.1:5555 。

连接指定设备：当有多个设备连接时，若要连接指定设备，可使用 “hdc -t ” 命令格式，其中 “” 可以通过 “hdc list targets” 命令获取，它类似于设备的唯一标识。比如，若要给设备 “FMR0223C13000649” 安装应用，就可以执行 “hdc -t FMR0223C13000649 install entry-default-signed.ha