upgrading-expo - new-architecture

新架构新架构在 Expo SDK 53 中默认启用。它用更快的同步通信层取代了传统桥接连接 JavaScript 与原生代码。文档完整指南https://docs.expo.dev/guides/new-architecture/变更内容JSIJavaScript 接口— JS 与原生之间直接同步调用Fabric— 支持并发特性的新渲染系统TurboModules— 带类型安全的懒加载原生模块SDK 兼容性SDK 版本新架构状态SDK 53默认启用SDK 52通过 app.json 选择启用SDK 51-实验性配置新架构默认启用。要显式禁用不推荐{expo:{newArchEnabled:false}}Expo GoExpo Go 自 SDK 53 起仅支持新架构。使用旧架构的应用必须使用开发构建。常见迁移问题原生模块兼容性一些较旧的原生模块可能不支持新架构。请检查模块文档中是否支持新架构GitHub issue 中的兼容性讨论如果模块无人维护考虑替代方案ReanimatedReact Native Reanimated 在 SDK 54 中需要react-native-workletsnpx expoinstallreact-native-worklets布局动画某些布局动画的行为有所不同。升级后请彻底测试。验证新架构检查新架构是否处于活动状态import { Platform } from react-native; // 如果 Fabric 已启用则返回 true const isNewArch global._IS_FABRIC ! undefined;从命令行验证当前运行的应用是否使用新架构bunx xcobra expo eval _IS_FABRIC-true故障排除清除缓存—npx expo start --clear清理 prebuild—npx expo prebuild --clean检查原生模块— 确保所有依赖都支持新架构查看控制台警告— 旧模块会记录兼容性警告