开发者选项开启指南：HermesAgent无线调试方法

本文详细介绍了在 Android 11 及更高版本中，如何正确开启开发者选项并配置 HermesAgent 以实现稳定高效的无线调试——不仅涵盖启用开发者模式、USB 调试和无线调试等基础步骤，还深入解析了 ADB 配对连接、Hermes 引擎启用、Debug 模式运行及 Chrome DevTools/Flipper 协同调试的关键要点，同时提供常见断连、授权失败、Hermes 不可用等问题的精准排查方案，助 React Native 开发者摆脱线缆束缚，真正享受流畅、可靠的无线调试体验。

在 Android 11 及更高版本中，无线调试（Wireless Debugging）已取代旧版 ADB over Wi-Fi，成为官方推荐的无线调试方式。HermesAgent 是 React Native 调试体系中的关键组件，负责 JS 线程与原生线程间的通信。要使其在无线调试模式下正常工作，必须确保设备端调试环境完整启用，而不仅仅是打开“无线调试”开关。

开启开发者选项与无线调试基础设置

先确认设备已启用开发者选项：连续点击“关于手机”→“版本号”7次。随后进入“设置 → 系统 → 开发者选项”，开启以下三项：

• USB 调试（部分设备要求先启用才能激活无线调试）
• 无线调试（主开关，开启后会提示配对码和 IP:Port）
• 通过网络启用 ADB（部分厂商定制系统需单独开启，如小米、华为）

配对设备并建立稳定 ADB 连接

无线调试启用后，设备会显示一个临时配对码和监听地址（如 192.168.1.105:42103）。此时需在开发机执行：

adb pair 192.168.1.105:42103
# 输入屏幕上显示的6位配对码
adb connect 192.168.1.105:42103

成功后运行 adb devices 应显示 device 状态。若显示 unauthorized，请检查设备弹出的授权弹窗是否已允许；若连接失败，请确认设备与电脑在同一局域网，且防火墙未拦截端口。

确保 Hermes 引擎与调试服务协同工作

HermesAgent 不是独立进程，而是由 React Native 启动时按需加载的 JS 运行时模块。无线调试生效的前提是：

• App 使用的是 Hermes 引擎（hermesEnabled: true 在 android/app/build.gradle 中配置）
• 调试模式启动（react-native run-android --variant=debug 或摇动设备调出菜单 → “Debug”）
• Chrome DevTools 或 Flipper 已连接至 http://localhost:8081/debugger-ui，且控制台无 Hermes is not available 报错

若 HermesAgent 未响应，可尝试在 App 启动后立即执行：adb shell am broadcast -a com.facebook.react.DEBUG_SERVER_HOST -e DEBUG_SERVER_HOST "192.168.1.105:8081"，手动注入调试服务器地址。

常见问题速查

• 设备重启后无线调试自动关闭？→ 需重新开启“无线调试”开关，配对信息不持久
• Flipper 显示 “No Hermes instance found”？→ 检查是否启用了 Hermes，以及是否在 Debug 构建下运行
• Chrome 调试器断连频繁？→ 关闭设备省电模式，禁用“优化电池使用”对 adb 和 App 的限制

好了，本文到此结束，带大家了解了《开发者选项开启指南：HermesAgent无线调试方法》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多科技周边知识！