HDC是什么？

HDC（HarmonyOS Device Connector），可以理解为鸿蒙生态系统中的 ADB。它是专为 HarmonyOS/OpenHarmony 开发人员设计的一款命令行调试工具，作用就是在电脑上管理、调试连接到电脑的鸿蒙设备（比如手机、平板、手表等真机，或者模拟器）

HDC提供了以下核心功能：

• 设备管理：查询已连接的设备列表，建立或断开设备连接。

• 应用管理：安装、卸载应用（.hap文件），查看已安装应用列表。

• 文件传输：在电脑和设备之间双向传输文件。

• 执行 Shell 命令：直接在设备上执行 Linux 命令，或进入设备的 Shell 环境。

• 查看日志：获取设备的运行日志，用于调试和分析问题。

• 高级调试：获取 root 权限、读写挂载系统分区、端口转发、性能数据采集等

一.HDC安装及环境变量配置

1.DevEco Studio下载

下载链接官网：下载中心 | 华为开发者联盟-HarmonyOS开发者官网，共建鸿蒙生态

（根据电脑版本下载安装即可）

2.配置环境变量

3.调试

命令行输入hdc，有以下显示即为安装成功

二.安装hap安装包命令

①下载安装包（.hap文件）

②使用数据线连接电脑与手机

注意：手机需打开《开发者模式》，连接后手机弹窗都点同意（若有弹窗的话），传输方式选择传输文件

③查询当前连接的设备id

hdc list targets

④安装命令

hdc -t 设备id install D:\entry-default-signed.hap（改成自己电脑安装包存放路径）

看到Successfully即为安装成功

二.安装鸿蒙包报错案例排查（常见错误码）

错误码	简要含义	快速处理
9568322	签名验证失败	提供 UDID 给开发重新签名
9568297	SDK 版本不匹配	确认设备 API 版本，重新打包
9568286	应用已存在	卸载或使用 -r 覆盖安装
9568305	证书无效	检查设备时间，更新证书
9568277	空间不足	清理存储空间
9568299	用户权限限制	开启“未知来源安装”
9568281	签名格式错误	检查打包配置，使用 DevEco 正常签名
9568282	应用与系统不兼容	检查应用支持的 API 范围