HarmonyOS Mac hdc 环境变量设置_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工具：

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

2. 手动下载方式

若需要手动获取：

# 创建SDK目录mkdir -p ~/HarmonyOS/Sdkcd ~/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/Sdkexport PATH=$PATH:$OHOS_HOME/openharmony/9/toolchains

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

4. 使配置立即生效：

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

三、验证安装

hdc -v

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

HDC version 2.0.0Build 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-rulessudo udevadm trigger

五、常用命令速查

六、常见问题解决

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文档。

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