原生鸿蒙(HarmonyOS 5+)从插线到 hdc 识别的完整流程
STEP 7 / 7
进阶:无线连接与多设备指定
无线连接(手机与电脑同一网络)
- 开发人员选项 → 打开「无线调试」,界面会直接显示 IP:端口;
$ hdc tconn 192.168.1.100:10123
Connect OK
$ hdc list targets
192.168.1.100:10123 Connected
- 断开用
hdc tconn IP:端口 -remove;官方注明 TCP 调试尚未完全稳定,建议测试用途; - 旧法
tmode port需要先插一次 USB,新机直接用上面的方式。
多设备同时连接
插多台设备(或连了模拟器 127.0.0.1:5555)时,先 hdc list targets -v 看连接键,再用 -t 指定目标:
$ hdc list targets -v
USB ABC123 USB Connected localhost
TCP 192.168.1.100:10123 Conn. Connected
$ hdc -t ABC123 shell
$ hdc -t 192.168.1.100:10123 install -r demo.hap
- USB 设备的 connect-key 就是序列号,无线/模拟器是 IP:端口;单设备时可省略 -t;
- 匹配不到目标会报
[Fail]Not match target founded——检查 connect-key 是否抄对。
✓本步完成标志:能用 -t 在多台设备间自由切换,或脱离数据线完成无线连接。
⚠️ 这一步可能遇到的意外情况(点击跳转排查)