HarmonyOS鸿蒙Next中macOS真机调试(无线调试)

HarmonyOS鸿蒙Next中macOS真机调试(无线调试)

无线调试时，输入：

hdc tconn 手机IP:端口号

提示: command not found: hdc
解决方法：手动设置一下环境变量。

一：确定DevEco-Studio 有hdc

  • 右键DevEco-Studio.app，显示包内容，hdc路径：Contents/sdk/default/openharmony/toolchains/hdc

二：添加环境变量

  • 打开.zshrc 文件, 终端输入:
open ~/.zshrc
  • 在.zshrc文件最下方添加：
export PATH="/Applications/DevEco-Studio.app/Contents/sdk/default/openharmony/toolchains:$PATH"
  • 保存后终端执行：
source ~/.zshrc

三：先“有线模式”连接，确认IP和端口：

  • 开启“开发者”：设置–>WIFI上面的设备名称–>连续点击“软件版本”
  • 连接到电脑，并开启“USB调试”：系统–>开发者选项–>USB调试
# 在电脑终端输入以下命令，获取设备IP和端口号：
hdc shell ifconfig  # 查看手机IP（通常在 wlan0 或 eth0 接口）
hdc fport           # 查看无线调试端口号（默认通常是 5555）

# 如果端口未开启，手动设置端口：
hdc tmode port 5555  # 设置端口为5555（可自定义）

四：切换到无线调试模式

hdc tconn 手机IP:端口号  # 例如：hdc tconn 192.168.1.100:5555

更多关于HarmonyOS鸿蒙Next中macOS真机调试(无线调试)的实战教程也可以访问 https://www.itying.com/category-93-b0.html

2 回复

在HarmonyOS Next中进行macOS真机无线调试需满足以下条件：

  1. 设备需运行HarmonyOS 3.1或更高版本
  2. 确保设备与macOS在同一局域网
  3. 设备开启开发者选项和USB调试

操作步骤：

  1. 通过USB连接设备
  2. 执行hdc shell hilog -s开启日志服务
  3. 运行hdc tconn IP:端口建立无线连接
  4. 断开USB后即可无线调试

调试命令：

  • hdc shell进入设备Shell
  • hdc file send传输文件
  • hdc app install安装应用

更多关于HarmonyOS鸿蒙Next中macOS真机调试(无线调试)的实战系列教程也可以访问 https://www.itying.com/category-93-b0.html


针对HarmonyOS Next在macOS上进行无线调试的问题，补充几点关键注意事项：

  1. 环境变量配置后建议验证是否生效：
which hdc

应返回正确的工具路径

  1. 端口设置后需确认防火墙状态：
hdc fport

若端口未开放，可能需要临时关闭macOS防火墙或添加端口例外

  1. 连接稳定性建议：
  • 确保设备与开发机在同一局域网
  • 建议使用5GHz频段Wi-Fi
  • 连接后可通过hdc list targets验证连接状态
  1. 常见错误处理：
  • “device not found”：检查USB调试是否开启
  • “connection refused”：确认端口号是否正确
  • 超时问题：尝试重启hdc服务hdc kill/hdc start
  1. 性能优化： 无线调试时建议关闭其他占用带宽的应用，大文件传输仍推荐使用USB连接

调试完成后，建议执行hdc tdisconn断开无线连接以释放资源。

回到顶部