简介

hdc（HarmonyOS Device Connector）是HarmonyOS为开发人员提供的用于调试的命令行工具，通过该工具可以在windows/linux/mac系统上与真实设备或者模拟器进行交互。

环境准备

hdc工具通过HarmonyOS SDK获取，存放于SDK的toolchains目录下，使用时将SDK的toolchains目录添加到环境变量。

跟我做

1、下载 调试软件 or 命令行

• DevEco Studio（推荐）：下载中心 | 华为开发者联盟-HarmonyOS开发者官网，共建鸿蒙生态

DevEco Studio是HarmonyOS应用及服务的集成开发环境（IDE），提供了一站式的开发平台，包括代码编辑、编译构建、代码调试、性能调优、模拟器、应用测试等能力。

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

Command Line Tools集合了HarmonyOS应用开发所用到的系列工具，包括SDK管理sdkmgr、代码检查codelinter、三方库的包管理ohpm、命令行解析hstack。

2、配置环境

1）打开终端工具，执行以下命令，根据输出结果分别执行不同命令。

echo $SHELL

• 如果输出结果为/bin/bash，则执行以下命令，打开.bash_profile文件。

vi ~/.bash_profile

• 如果输出结果为/bin/zsh，则执行以下命令，打开.zshrc文件。

vi ~/.zshrc

2）单击字母“i”，进入Insert模式。

【重点！！】输入以下内容，添加HDC_SERVER_PORT端口信息。

# HarmonyOS hdc for Studio

HDC_SERVER_PORT=7035
launchctl setenv HDC_SERVER_PORT $HDC_SERVER_PORT
export HDC_SERVER_PORT
HDC_SDK_PATH=/Applications/DevEco-Studio.app/Contents/sdk/HarmonyOS-NEXT-DB2/openharmony/toolchains/  #有安装Studio的前提下用这个
export PATH=$PATH:$HDC_SDK_PATH

# HarmonyOS hdc for Command Line Tools

HDC_SERVER_PORT=7035 
launchctl setenv HDC_SERVER_PORT $HDC_SERVER_PORT 
export HDC_SERVER_PORT
export PATH=~/command-line-tools/bin:$PATH #在PATH路径下添加环境变量。请以实际命令行工具存储路径为准

3）编辑完成后，单击Esc键，退出编辑模式，然后输入“:wq”，单击Enter键保存。

4）执行以下命令，使配置的环境变量生效。

• 如果步骤a时打开的是.bash_profile文件，请执行如下命令：

source ~/.bash_profile

• 如果步骤a时打开的是.zshrc文件，请执行如下命令：

source ~/.zshrc

5）环境变量配置完成后，关闭并重启DevEco Studio。

3、调试

开启终端/DevEco Studio-terminal

hdc -v

参考资料：

华为官方：

文档中心