SuperAPI AI 工具集

upgrading-expo

编程与开发

查看项目

更新于 10-16 03:05

技能介绍

用途:为 Expo/React Native 项目提供 SDK 版本升级的操作指南,覆盖依赖修复、破坏性变更检查、缓存清理与弃用包迁移。

主要能力:按版本列出迁移参考,包括 SDK 53 新架构迁移、SDK 54 的 React 19 变更(useContext 改为 use,Context.Provider 改为 Context,移除 forwardRef)、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(测试版带 .preview 后缀并发布在 @next 标签)。随后运行 npx expo-doctor 诊断,清缓存可执行 npx expo export -p ios --clear、rm -rf node_modules .expo、watchman watch-del-all。若升级涉及原生变更可运行 npx expo prebuild --clean,但需确认项目不是 bare workflow;存在 ios/ 或 android/ 目录时再清理 CocoaPods(cd ios && pod install --repo-update)、Xcode 派生数据(npx expo run:ios --no-build-cache)与 Gradle(cd android && ./gradlew clean)。

整理建议:检查 eslint 之外还包括删除 app.json 中的 sdkVersion、移除 package.json 中隐式的 @babel/core、babel-preset-expo、expo-constants,删除仅含默认配置的 babel.config.js 与 metro.config.js,审查 expo.install.exclude 与 patches/ 中不再需要的项,SDK 53 起移除 autoprefixer 并改用 postcss.config.mjs。

限制:资料仅覆盖上述版本与包,未提供的价格、平台支持范围、具体版本兼容矩阵暂未提供;命令执行前应自行确认项目类型与备份。