在 Mac 上配置和使用 HDC 工具的指南

环境和流程说明

1. 获取 hdc 工具：首先，你需要从 HarmonyOS SDK 的 toolchains 目录下获取 hdc 工具。这个工具是进行设备连接和调试的关键。

从 Preferences 的 SDK 可以看到具体的路径，如果 Toolchains 还没安装的可以重新安装

配置环境变量 HDC_SERVER_PORT：

打开终端工具。

通过执行echo $SHELL命令查看你当前使用的 shell 类型。

如果输出是/bin/bash，则编辑.bash_profile文件：vi ~/.bash_profile。

如果输出是/bin/zsh，则编辑.zshrc文件：vi ~/.zshrc。

进入 Insert 模式，添加以下内容：

HDC_SERVER_PORT=7035launchctl setenv HDC_SERVER_PORT $HDC_SERVER_PORTexport HDC_SERVER_PORT

保存并退出编辑模式。

首先，确保你在命令模式下。你可以按 Esc 键来切换到命令模式。

在命令模式下，输入以下命令并按 Enter：

:wq 

这将会保存当前文件并退出 vi 编辑器。

使环境变量生效：

如果是.bash_profile，执行source ~/.bash_profile。

如果是.zshrc，执行source ~/.zshrc。

配置全局环境变量

1. 添加 SDK 路径到 PATH：打开相应的配置文件（.bash_profile或.zshrc）。添加 SDK 路径到 PATH，例如：

HDC_SDK_PATH=/Users/konkapeng/HM/sdk/openharmony/10/toolchainslaunchctl setenv HDC_SDK_PATH $HDC_SDK_PATH（仅MacOS需要）export PATH=$PATH:$HDC_SDK_PATH保存并使环境变量生效。

注意事项

• 使用hdc kill -r命令可以杀掉异常进程并重启 hdc 服务。

• 如果hdc list targets获取不到设备信息，检查是否有 hdc 进程存在，并尝试重启 hdc 服务。

示例

export PATH=$PATH:/Users/konkapeng/HM/sdk/openharmony/10/toolchainsexport CLASSPATH HDC_SERVER_PORT=7035launchctl setenv HDC_SERVER_PORT $HDC_SERVER_PORTexport HDC_SERVER_PORT

• 第一行代码用于将 HDC 工具的路径添加到 PATH 环境变量中。

• 第二行代码设置 HDC 服务器的端口号为 7035。

• 第三行和第四行代码确保 HDC_SERVER_PORT 环境变量在系统启动时被正确设置。

通过以上步骤，你可以在 Mac 上配置好 HDC 工具的环境变量，并在任意目录下使用 HDC 命令。

konkapeng@konkas-MacBook-Pro LawGame % source ~/.zshrckonkapeng@konkas-MacBook-Pro LawGame % hdc --versionVer: 1.3.0a

可以看出已经设置成功

参考链接

• HDC工具文档
  

• Mac配置HDC工具环境变量