鸿蒙开发：使用无线调试连接真机

 一，环境配置

1. 使用真机无线调试，需要与真机建立连接：

  在开发工具DevEco Studio "Termimal" 窗口下使用命令行：hdc tconn 设备IP地址:端口号。如果报错"command not found: hdc"，说明电脑端还没有配置hdc环境变量。

2. hdc（HarmonyOS Device Connector）环境变量配置：

• Windows环境变量设置：

a. 在此电脑 > 属性 > 高级系统设置 > 高级 > 环境变量中，添加HDC端口变量名为：HDC_SERVER_PORT，变量值可设置为任意未被占用的端口，如7035。

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

• MacOS环境变量设置：

a. 打开终端工具，执行以下命令，根据输出结果分别执行不同命令:

      echo $SHELL 

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

      vi ~/.bash_profile

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

      vi ~/.zshrc

d. 单击字母“i”，进入Insert模式

e. 输入以下内容，添加HDC_SERVER_PORT端口信息

      export PATH=$PATH:/Users/**/toolchains

      export CLASSPATH

      HDC_SERVER_PORT=7035

      launchctl setenv HDC_SERVER_PORT $HDC_SERVER_PORT

      export HDC_SERVER_PORT

eg:

注意  PATH 路径要配置到sdk 的toolchains下。

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

g. 执行以下命令，使配置的环境变量生效：

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

        source ~/.bash_profile

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

        source ~/.zshrc

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

i. 在DevEco Studio 的"Terminal" 窗口输入"hdc -v" ，返回具体版本信息，则环境变量配置成功了。

二，使用命令行与真机连接：

1. 确保Phone/Tablet和PC连接到同一WLAN网络。

2. 在设置 > 系统 > 开发者选项中，打开“无线调试”开关，并获取Phone/Tablet端的IP地址和端口号:

3. 在"Terminal" 窗口输入以下命令行：

   hdc tconn 设备IP地址:端口号

输出 Connect OK 表示与设备连接成功

4. 重新运行App 

   若报错：Failed to get the device apiVersion. 尝试关闭"无线调试" 开关重新打开，更换端口号重新连接。

参考：

使用本地真机运行应用/服务

hdc使用指导