用途:指导 Expo 项目升级 SDK 版本并修复随之产生的依赖与配置问题,覆盖从升级命令到破坏性变更检查的完整流程。
主要能力:提供按版本划分的迁移参考文档,包括 SDK 53 新架构迁移、SDK 54 的 React 19 变更与 React Compiler 配置、SDK 55 原生标签页变更,以及 expo-av 音频/视频迁移到 expo-audio 与 expo-video 的指南。同时给出升级命令、诊断、缓存清理、预构建与废弃包替换表。
使用方式:安装最新版可执行 npx expo install expo@latest 与 npx expo install --fix;安装测试版使用 npx expo install expo@next --fix。随后运行 npx expo-doctor 诊断,必要时清缓存并重装。需要原生变更时执行 npx expo prebuild --clean,但仅限项目已有 ios/ 或 android/ 目录(非 CNG)时使用。裸工作流还需清理 CocoaPods、Xcode 缓存与 Gradle:cd ios && pod install --repo-update、npx expo run:ios --no-build-cache、cd android && ./gradlew clean。
其他事项:SDK 54 起需安装 react-native-worklets、在 app.json 添加 "experiments": { "reactCompiler": true }、删除 sdkVersion、移除隐式包与仅含默认配置的 babel.config.js 和 metro.config.js。废弃包需按替换表迁移,如 expo-av 换为 expo-audio 与 expo-video、expo-permissions 换为各包权限 API。注意审查 expo.install.exclude、patches 与 postcss 配置。限制:具体的兼容性与版本细节需查阅对应发布说明,资料未提供更细的验证结果。