在 Windows 环境下使用 HBuilderX 调试 Android 应用时,最关键的两个要素是:
- adb.exe 路径配置
- 模拟器端口配置
本文将这两个配置放在一起讲解,让你能够快速完成调试环境设置。
1. 一张图看懂整体流程
css
[找到 adb.exe ] --> [配置到 HBuilderX ] --> [adb devices 查看端口 ]
| |
| ↓
+-->(可选:加到系统环境变量) [配置模拟器端口到 HBuilderX ]
只要 adb 路径正确 + 端口匹配正确,HBuilderX 就能识别模拟器。
2. 配置 adb 路径 + 模拟器端口(并列说明)
① 在 HBuilderX 中设置 ADB 路径
进入:
rust
运行 -> 运行到手机或模拟器 -> adb 路径设置
将模拟器或 Android SDK 的 adb.exe 填入,例如:
makefile
C:\Android\platform-tools\adb.exe
或者模拟器自带的 adb,例如联想模拟器:
makefile
C:\Program Files\LenovoSimulator\adb.exe
② 同时配置模拟器端口(与 adb 一起配)
同一位置即可设置模拟器端口:
rust
运行 -> 运行到手机或模拟器 -> Android 模拟器端口
填入你 adb devices 中看到的端口,例如:
11509
记住:端口必须与 adb devices 输出一致,否则不会识别模拟器。
3. 如何快速找到 adb.exe 与端口?(关键部分)
(1)找到 adb.exe
你可以从以下位置找到:
| 来源 | adb.exe 位置示例 |
|---|---|
| Android SDK | C:\Android\platform-tools\adb.exe |
| 联想模拟器 | 安装目录下查找 adb.exe |
| 夜神、MuMu、雷电等模拟器 | 安装目录通常包含 adb.exe |
如果找不到,直接搜索:
在模拟器安装目录搜索:adb.exe
(2)查看模拟器端口
CMD 或 PowerShell 执行:
adb devices
如果看到类似:
makefile
127.0.0.1:11509 device
说明:
- 设备 IP:127.0.0.1(本机)
- 端口号:11509
- 状态:device(已连接)
这个端口号就是你要配置给 HBuilderX 的端口。
4. ADB 故障排查(与端口一起操作)
为了让「端口 + ADB」统一操作,这里整理成连贯流程:
步骤 1:确保 adb 可用
adb devices
若提示找不到 adb → adb 路径配置错误 → 重新设置到 HBuilderX。
步骤 2:重启 adb 服务(若无法识别设备)
perl
adb kill-server # 关闭 adb
adb start-server # 重启 adb
解释:
重启 adb 可以解决 80% 的连接失败。
步骤 3:手动连接模拟器端口
arduino
adb connect 127.0.0.1:11509
作用:
- 强制让 adb 连接模拟器端口
- 避免模拟器未自动注册到 adb 列表的问题
再次查看:
adb devices
应看到:
makefile
127.0.0.1:11509 device
步骤 4:把端口 + adb 地址一起配到 HBuilderX
adb 路径:
makefile
C:\Program Files\LenovoSimulator\adb.exe
模拟器端口:
11509
HBuilderX 立刻能识别模拟器。
5. 完整简明总结(保证一看就懂)
✔ 配 adb.exe
HBuilderX → 运行 → adb 路径设置
✔ 配模拟器端口
HBuilderX → 运行 → Android 模拟器端口
✔ 用 adb devices 查端口
如看到:127.0.0.1:11509 device → 配 11509 即可
✔ 无法识别设备?
执行:
perl
adb kill-server
adb start-server
adb connect 127.0.0.1:11509
本文部分内容借助 AI 辅助生成,并由作者整理审核。