React-Native v0.69.6 + EAS构建APK卡在启动页问题求助

以下是针对该问题的具体排查步骤和解决方法：

• 检查EAS构建配置
  确认eas.json中的Android构建配置是否正确。如果目标是生成APK，需确保对应构建profile的android.buildType设置为apk，而非默认的App Bundle格式。可执行eas build:configure重新生成标准配置文件，覆盖可能存在错误的自定义设置。

• 适配EAS CLI与RN版本
  React Native 0.69.x对EAS CLI版本有兼容性要求，过低版本易引发问题。执行npm install -g eas-cli升级到最新稳定版，之后重新尝试构建。同时检查package.json中react-native、@react-native-community/cli等核心依赖的版本是否匹配，避免依赖冲突。

• 排查启动页原生配置
  检查Android原生启动页的资源与布局：

  • 确认android/app/src/main/res/layout/launch_screen.xml布局文件无语法错误，组件引用正常；
  • 检查launch_screen.png等启动页图片资源是否存在于对应分辨率的资源目录中，无缺失或损坏。

• 分析构建与运行日志

  • 重新执行构建命令（如eas build -p android --profile preview），实时查看构建过程中的警告和错误信息，重点关注依赖安装、原生编译环节的异常；
  • 将APK安装到真机后，通过adb logcat *:E查看运行时错误日志，或用adb logcat | grep ReactNative过滤React Native相关日志，定位JS bundle加载失败、原生模块初始化错误等具体问题。

• 清理缓存后重新构建
  依次执行以下命令清理各类缓存，再重新构建：

  npx react-native clean
  eas build:clear-cache
  rm -rf android/build  # Mac/Linux环境；Windows环境用 rd /s /q android\build
  

内容的提问来源于stack exchange，提问作者Kada Guetouache