HarmonyOS Mac hdc 环境变量设置
✍️作者简介：小北编程（专注于HarmonyOS、Android、Java、Web、TCP/IP等技术方向）
🐳博客主页： 开源中国、稀土掘金、51cto博客、博客园、知乎、简书、慕课网、CSDN
🔔如果文章对您有一定的帮助请👉关注✨、点赞👍、收藏📂、评论💬。
🔥如需转载请参考【转载须知】
文章目录
- 一、获取HDC工具
- 1. 通过DevEco Studio安装
- 2. 手动下载方式
- 二、配置环境变量
- 1. 确定HDC路径
- 2. 配置环境变量
- 方法一：临时配置（仅当前终端有效）
- 方法二：永久配置（推荐）
- 三、验证安装
- 四、USB设备连接配置
- 1. 配置USB权限
- 2. 重新加载规则
- 五、常用命令速查
- 六、常见问题解决
- 七、进阶配置
- 1. 配置命令别名
- 2. 自动补全配置
- 八、卸载HDC工具
HDC（HarmonyOS Device Connector）是HarmonyOS开发中不可或缺的命令行工具，本文将详细介绍在Mac系统上配置和使用HDC的全过程。
一、获取HDC工具
1. 通过DevEco Studio安装
推荐通过DevEco Studio自动安装HDC工具：
- 下载安装DevEco Studio
- 首次启动时选择"Standard"安装模式
- 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
方法二：永久配置（推荐）
-
打开终端，编辑shell配置文件：
# 如果是zsh用户（Mac默认） nano ~/.zshrc # 如果是bash用户 nano ~/.bash_profile -
在文件末尾添加：
# HarmonyOS HDC配置 export OHOS_HOME=~/Library/Huawei/Sdk export PATH=$PATH:$OHOS_HOME/openharmony/9/toolchains -
保存文件（Ctrl+O），退出编辑器（Ctrl+X）
-
使配置立即生效：
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 |
六、常见问题解决
-
“zsh: command not found: hdc”
- 检查环境变量配置是否正确
- 确认
source了配置文件 - 检查HDC工具路径是否存在
-
设备连接失败
# 先终止已有服务 hdc kill # 重新启动 hdc start -
权限不足问题
# 查看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工具
- 删除环境变量配置
- 移除SDK目录：
rm -rf ~/Library/Huawei/Sdk # 或手动安装的 rm -rf ~/HarmonyOS/Sdk
通过本文的详细指导，您应该已经掌握了HDC工具的完整配置和使用方法。如需了解更多高级功能，请参考官方HDC文档。
👍 点赞，是我创作的动力！
⭐️ 收藏，是我努力的指引！
✏️ 评论，是我进步的宝藏！
💖 衷心感谢你的阅读以及支持！
