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

Expo构建Android预览版APK后卡在启动页求助

Android预览版APK卡在启动页的排查方案

以下是针对你用eas build -p android --profile preview构建后启动卡住的问题,结合你的package.json给出的排查步骤:

  • 启动页异步操作未完成
    你依赖expo-app-loading和expo-font加载字体,大概率是字体加载失败或未正确关闭启动页。要确保字体加载完成后调用SplashScreen.hideAsync(),同时检查是否加载了所有用到的字体变体。另外,expo 46开始官方更推荐用expo-splash-screen的API替代expo-app-loading,后者可能存在兼容性问题,建议迁移。

  • 第三方库冲突或适配问题

    • 你同时安装了react-icons和@expo/vector-icons,react-icons是Web端库,在React Native中会导致兼容性问题,直接移除react-icons,统一用@expo/vector-icons即可。
    • 确认react-native-svg-transformer的metro配置正确,如果项目里用了SVG组件,配置错误会导致构建时资源加载失败,进而卡住启动。
  • EAS构建配置问题
    检查eas.json的preview配置,若开启了代码混淆或压缩,可能误删了启动所需的关键代码。可以临时关闭minifyEnabled测试:

    {
      "build": {
        "preview": {
          "android": {
            "minifyEnabled": false
          }
        }
      }
    }
    
  • 查看设备错误日志
    用adb连接设备,执行adb logcat *:E查看错误日志,能直接定位问题——比如字体文件缺失、AsyncStorage初始化失败、导航容器错误、启动时的网络请求异常等。

  • AsyncStorage初始化异常
    如果启动逻辑依赖AsyncStorage读取数据,要处理读取失败的情况,比如Android权限问题或存储数据格式错误,这些都会导致启动流程阻塞。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.08.17 07:35:19