如何在真实Android设备上调试React Native应用？是否需第三方插件？

核心结论 #

不需要安装第三方插件，React Native自带完整的调试工具链，按以下步骤操作即可实现调试。

一、设备准备工作 #

• 开启开发者选项：进入设备「设置」→「关于手机」，连续点击版本号直到提示开启开发者选项；返回设置主页面，找到并进入「开发者选项」。
• 启用关键调试开关：开启「USB调试」、「USB安装」（部分设备显示为「USB调试（安全设置）」，允许调试权限）。
• 电脑端配置：确保已安装对应设备的ADB驱动（可通过Android Studio的SDK管理器安装通用驱动，或连接设备时按系统提示安装）。

二、调试步骤（USB连接优先推荐） #

1. 安装调试版APK
   发布版APK无法开启调试功能，若之前安装的是发布版，先卸载，再在项目根目录运行：

   npx react-native run-android
   

   该命令会自动编译并安装调试版APK到设备。

2. 启动本地开发服务器
   在项目根目录执行：

   npx react-native start
   

   保持服务器运行，不要关闭终端窗口。

3. 连接设备与服务器

   • USB连接场景：设备通过USB线连接电脑后，选择「文件传输」模式，运行npx react-native run-android后，应用会自动连接本地服务器。
   • 无线连接场景（同局域网）：在设备上打开RN应用，摇一摇设备（或在开发者选项中找到「调试APP」选择你的应用），弹出调试菜单后，选择「Debug JS Remotely」，输入电脑的局域网IP地址+端口（默认xxx.xxx.xxx.xxx:8081）。

4. 开始调试

   • JS代码调试：开启「Debug JS Remotely」后，会自动打开Chrome开发者工具，可查看控制台日志、设置断点、检查网络请求。
   • 实时更新：在调试菜单中开启「Fast Refresh」（或旧版的「Hot Reloading」），修改代码后无需重新编译，设备上会实时显示更新效果。
   • 原生代码调试：若需调试Android原生部分，用Android Studio打开项目的android目录，连接设备后直接设置断点调试即可。

三、常见问题排查 #

• 设备未被识别：运行adb devices查看设备列表，若为空，检查USB线、驱动、USB调试开关是否正常。
• 服务器连接失败：确认设备与电脑在同一局域网（无线场景），关闭电脑防火墙，或重启本地服务器。

内容的提问来源于stack exchange，提问作者VisualEmail Keto