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

React Native APK安装运行时触发Metro错误,已配置cleartextTraffic仍未解决

解决React Native Debug APK安装后报错问题
  • 生成包含离线Bundle的Debug APK
    直接通过react-native run-android运行时,应用依赖本地Metro服务器实时加载代码,但GitHub上的Debug APK默认可能没打包离线Bundle,导致安装后无法加载资源。执行以下步骤生成带Bundle的APK:

    1. 生成离线Bundle文件:
      react-native bundle --platform android --dev true --entry-file index.js --bundle-output android/app/src/main/assets/index.android.bundle --assets-dest android/app/src/main/res/
      
    2. 重新编译Debug APK:
      cd android && ./gradlew assembleDebug
      

    用这个新生成的APK安装测试。

  • 配置Debug服务器地址(或启用离线模式)
    如果需要连接本地Metro调试,确保手机和电脑在同一WiFi网络:

    1. 打开应用后摇一摇唤出开发者菜单,选择「Dev Settings」
    2. 进入「Debug server host & port for device」,输入你的电脑IP地址+Metro端口(比如192.168.1.100:8081)
    3. 或者直接勾选「Enable Offline Bundle」,让应用使用本地打包的资源,无需连接Metro
  • 检查基础权限配置
    确认AndroidManifest.xml里是否添加了网络权限:

    <uses-permission android:name="android.permission.INTERNET" />
    

    虽然Debug模式默认会添加,但如果被误移除也会导致网络连接相关错误。

  • 重置Metro缓存
    缓存异常可能导致Bundle生成不完整,执行以下命令清空缓存后重新打包:

    react-native start --reset-cache
    

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.08.05 16:15:51