先说说最基础的检查项。数据线一定要用原装的,这点特别重要。很多开发者随便找根充电线就往上插,结果传输数据不稳定。还有开发者选项里的USB调试必须打开,这个虽然老生常谈,但确实有人会忘记。另外建议把USB调试(安全设置)也开启,允许通过USB安装应用。
端口占用问题也是个常见杀手。Metro默认跑在8081端口,有时候会被其他程序占用。可以在终端输入查看端口占用情况,如果发现有其他进程占用,直接结束掉。或者更简单的方法,在react-native run-android时加上指定新端口,记得手机和电脑要在同一个网络下。
网络环境这个坑我踩得最深。有时候连着公司VPN就跑不通了,必须断开VPN才能正常连接。还有防火墙设置,特别是Windows系统,要把node.exe和Metro相关进程加入白名单。如果用的是公共WiFi,要注意有些公共网络会隔离设备间的通信,这时候最好开手机热点来测试。
说到ADB这个神器,真是调试必备。经常遇到设备明明连着电脑,但就是识别不出来。这时候可以试试然后重启服务。还有个骚操作,拔掉数据线重新插的同时立即执行,有时候就能识别了。
对于Android 10以上的机型,cleartext traffic问题要特别注意。在android/app/src/main/AndroidManifest.xml里application标签下加上,不过正式发布记得去掉这个配置。
有时候问题出在缓存上。可以试试这几个命令组合拳:清空Metro缓存,然后清理gradle缓存,最后重新。别看步骤简单,能解决很多玄学问题。
真机调试时还要注意APP的打包配置。检查android/app/build.gradle里的debug配置,确保applicationId和buildTypes配置正确。有时候因为签名配置问题导致安装失败,可以先用卸载旧版本再重装。
遇到红屏错误时,仔细看错误信息特别重要。如果是关于assets资源加载失败,可以手动执行来生成bundle文件。
最后分享个偏方,当所有方法都试过还是不行时,重启大法值得一试------重启电脑、重启手机、重启Metro服务。别笑,这个方法真的解决过不少疑难杂症。还有就是保持耐心,真机调试本来就会遇到各种环境问题,多尝试几种方案总能找到解决办法。