HarmonyOS Mac hdc 环境变量设置

✍️作者简介：小北编程（专注于HarmonyOS、Android、Java、Web、TCP/IP等技术方向）
🐳博客主页： 开源中国、稀土掘金、51cto博客、博客园、知乎、简书、慕课网、优快云
🔔如果文章对您有一定的帮助请👉关注✨、点赞👍、收藏📂、评论💬。
🔥如需转载请参考【转载须知】

HDC（HarmonyOS Device Connector）是HarmonyOS开发中不可或缺的命令行工具，本文将详细介绍在Mac系统上配置和使用HDC的全过程。

一、获取HDC工具

1. 通过DevEco Studio安装

推荐通过DevEco Studio自动安装HDC工具：

1. 下载安装DevEco Studio
2. 首次启动时选择"Standard"安装模式
3. SDK将自动下载到~/Library/Huawei/Sdk目录

2. 手动下载方式

若需要手动获取：

# 创建SDK目录
mkdir -p ~/HarmonyOS/Sdk
cd ~/HarmonyOS/Sdk

# 下载SDK工具链（版本号请替换为最新）
wget https://developer.harmonyos.com/cn/docs/release/sdk/openharmony_toolchains-{版本号}-darwin.zip

# 解压文件
unzip openharmony_toolchains-{版本号}-darwin.zip

二、配置环境变量

1. 确定HDC路径

首先找到HDC的实际安装路径，通常在：

~/Library/Huawei/Sdk/openharmony/{版本号}/toolchains/

或手动安装的：

~/HarmonyOS/Sdk/toolchains/

2. 配置环境变量

方法一：临时配置（仅当前终端有效）

export PATH=$PATH:~/Library/Huawei/Sdk/openharmony/9/toolchains

方法二：永久配置（推荐）

1. 打开终端，编辑shell配置文件：

   # 如果是zsh用户（Mac默认）
   nano ~/.zshrc
   
   # 如果是bash用户
   nano ~/.bash_profile
   

2. 在文件末尾添加：

   # HarmonyOS HDC配置
   export OHOS_HOME=~/Library/Huawei/Sdk
   export PATH=$PATH:$OHOS_HOME/openharmony/9/toolchains
   

3. 保存文件（Ctrl+O），退出编辑器（Ctrl+X）

4. 使配置立即生效：

   source ~/.zshrc  # 或 source ~/.bash_profile
   

三、验证安装

hdc -v

成功安装将显示类似信息：

HDC version 2.0.0
Build info:2023-06-01 16:30:45

四、USB设备连接配置

1. 配置USB权限

# 查看设备列表
system_profiler SPUSBDataType

# 创建udev规则文件
sudo nano /etc/udev/rules.d/99-harmonyos.rules

添加以下内容（替换vendorid为实际值）：

SUBSYSTEM=="usb", ATTR{idVendor}=="你的设备VID", MODE="0666", GROUP="plugdev"

2. 重新加载规则

sudo udevadm control --reload-rules
sudo udevadm trigger

五、常用命令速查

命令	功能	示例
hdc list targets	查看连接设备	-
hdc shell	进入设备shell	-
hdc file send	发送文件到设备	hdc file send local.txt /data/local/
hdc install	安装应用	hdc install app.hap
hdc hilog	查看系统日志	hdc hilog -w

六、常见问题解决

1. “zsh: command not found: hdc”

   • 检查环境变量配置是否正确
   • 确认source了配置文件
   • 检查HDC工具路径是否存在

2. 设备连接失败

   # 先终止已有服务
   hdc kill
   # 重新启动
   hdc start
   

3. 权限不足问题

   # 查看USB设备权限
   ls -l /dev/bus/usb/*
   
   # 临时解决方案
   sudo chmod 666 /dev/bus/usb/XXX/YYY
   

七、进阶配置

1. 配置命令别名

在~/.zshrc中添加：

alias hdc-list='hdc list targets'
alias hdc-log='hdc hilog -w'

2. 自动补全配置

# 创建补全脚本目录
mkdir -p ~/.zsh_completion

# 生成HDC命令补全
hdc --generate-completion=zsh > ~/.zsh_completion/_hdc

# 在.zshrc中添加
fpath=(~/.zsh_completion $fpath)
autoload -U compinit && compinit

八、卸载HDC工具

1. 删除环境变量配置
2. 移除SDK目录：

   rm -rf ~/Library/Huawei/Sdk
   # 或手动安装的
   rm -rf ~/HarmonyOS/Sdk
   

通过本文的详细指导，您应该已经掌握了HDC工具的完整配置和使用方法。如需了解更多高级功能，请参考官方HDC文档。

👍 点赞，是我创作的动力！
⭐️ 收藏，是我努力的指引！
✏️ 评论，是我进步的宝藏！
💖 衷心感谢你的阅读以及支持！