Expo SDK 46升49后expo-updates报错及EAS打包崩溃问题

问题背景 #

将Expo SDK从46版本升级到49版本，更新所有依赖包后遇到expo-updates相关问题。应用采用RTL布局，默认语言为阿拉伯语（ar），首次启动或用户切换语言时需要重载应用。

遇到的问题 #

1. Expo Go中运行的警告 #

首次在Expo Go中运行时出现以下警告：

WARN [Error: You cannot use the Updates module in development mode in a production app. To test manual updates, publish your project using expo publish and open the published version in this development client.]

2. 独立构建应用崩溃/卡在启动页 #

使用命令 eas build -p android --profile qaMA 生成独立应用时，应用崩溃或卡在启动页。

相关代码片段 #

重载应用的核心代码：

const loadI18n = async () => {
      const lang: string | null = await localStorage.getValue("lang");
      const selectedLanguage: LanguageModel = env.languages.find((x: LanguageModel) => x.lang === ((lang !== null) ? lang : env.defaultLanguage));

      if (lang === null) {
        localStorage.save("lang", env.defaultLanguage);
      } else {
        console.log("a language is already selected, The language: ", lang)
      }
      i18n.init()
        .then(async () => {
          console.log("==============> I18nManager.isRTL: ", I18nManager.isRTL)
          const RNDir = selectedLanguage.layout;
          console.log("isRTL: ", RNDir);
          console.log("current language is :", i18next.language, "i18n.dir: ", i18n.dir);
          if ((i18n.dir !== RNDir) || (!I18nManager.isRTL && selectedLanguage.layout === 'RTL')) {
            console.log("isRTL: ", RNDir);
            console.log("current language is :", i18next.language, "i18n.dir: ", i18n.dir);
            const isLocaleRTL = selectedLanguage.layout === 'RTL';
            I18nManager.forceRTL(isLocaleRTL);
            I18nManager.allowRTL(isLocaleRTL);
            console.log("isLocaleRTL: ", selectedLanguage.layout === 'RTL');
            await Updates.reloadAsync();
          }
          setIsI18nInitialized(true);
        })
        .catch((error: any) => console.warn(error));
    }

EAS配置文件 #

{
  "cli": {
    "version": ">= 3.5.2"
  },
  "build": {
    "qaMA": {
      "android": {
        "gradleCommand": ":app:assembleRelease"
      },
      "releaseChannel": "qa",
      "env": {
        "APP_COUNTRY": "MA"
      }
    }
  },
  "submit": {
    "production": {}
  }
}

解决步骤 #

1. 处理Expo Go中的警告 #

expo-updates在Expo Go开发模式下有使用限制，需区分环境调用重载逻辑：

import Constants from 'expo-constants';
import { DevSettings } from 'react-native';

// ... 原有逻辑
if ((i18n.dir !== RNDir) || (!I18nManager.isRTL && selectedLanguage.layout === 'RTL')) {
  // ... RTL设置代码
  // 生产/预览模式用Updates重载，开发模式用DevSettings
  if (__DEV__) {
    DevSettings.reload();
  } else {
    await Updates.reloadAsync();
  }
}

2. 排查独立构建的崩溃问题 #

（1）更新expo-updates配置

SDK 49中expo-updates配置要求更严格，确保app.json/app.config.js中：

• updates.enabled设为true（生产环境）
• 配置合理的runtimeVersion，例如和expo.version保持一致

（2）调整启动重载时机

启动阶段过早调用Updates.reloadAsync()易引发崩溃，建议：

• 将loadI18n放在useEffect中，确保应用基础初始化完成后执行
• 添加防抖逻辑，避免因状态反复变化触发无限重载循环

（3）查看日志定位问题

• 执行eas build时查看完整构建日志，搜索error/crash关键词
• 用adb logcat抓取Android设备崩溃日志，定位具体报错栈信息

（4）升级EAS CLI版本

SDK 49推荐搭配更高版本的EAS CLI，修改配置文件：

{
  "cli": {
    "version": ">= 5.0.0"
  },
  // ... 其他配置
}

3. RTL布局兼容调整 #

SDK 49中I18nManager行为有细微变化，需注意：

• 调用forceRTL和allowRTL后，添加短暂延迟再触发重载，避免状态未同步完成
• 验证i18n.dir的判断逻辑，确保不会进入无限重载循环

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