You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

App构建成功但打开白屏,构建后出现Gradle废弃特性及adb未识别报错

问题排查与解决步骤

1 修复adb不存在错误

这个是当前最核心的报错,直接导致应用启动失败、开发服务器连接中断:

  • 确认本地已安装Android SDK的platform-tools组件,adb工具默认存放在该组件的目录下
  • 将adb所在目录添加至Windows系统环境变量的Path中,默认路径为C:\Users\你的系统用户名\AppData\Local\Android\Sdk\platform-tools
  • 配置完成后重启命令行工具,执行adb version验证,输出版本信息即为配置成功
  • 重新执行应用运行命令,该报错即可消除,adb reverse命令可正常连通设备与开发服务器

2 处理Gradle废弃特性警告

该警告不影响本次构建成功,但会导致后续无法升级到Gradle 7.0版本:

  • 进入项目根目录下的android文件夹,打开命令行执行gradlew.bat --warning-mode all,查看所有废弃特性的具体告警详情
  • 根据告警提示逐一修改对应Gradle配置,比如更新过时插件版本、替换废弃的Gradle语法即可

3 解决App白屏问题

白屏的根本原因是应用无法加载JS业务包,对应两种场景处理:

  • debug包场景:adb配置完成后,确保手机和电脑连接在同一个WiFi网络下,打开App的开发者调试菜单,将调试服务器地址设置为「电脑本地IP:8081」,重新加载应用即可正常显示
  • release包场景:检查打包前是否执行了JS资源打包命令,未内置JS包的release包打开会直接白屏,需先执行react-native bundle --platform android --dev false --entry-file index.js --bundle-output android/app/src/main/assets/index.android.bundle --assets-dest android/app/src/main/res,再执行release打包操作

内容的提问来源于stack exchange,提问作者Tariq Nazir

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.15 10:24:10