SuperAPI AI 工具集

expo-upgrade

编程与开发

查看项目

更新于 10-27 12:59

技能介绍

expo-upgrade 是一份面向 Expo 项目升级的指南型技能,主要用途是指导开发者将 Expo SDK 升级到新版本,并处理随之出现的依赖与配置问题。

主要能力: 它按主题给出了升级过程中需要关注的要点,包括 React 19 相关变化(useContext 改为 use、Context.Provider 改为 Context、移除 forwardRef)、新架构迁移、React Compiler 配置、原生标签(NativeTabs.Trigger.)访问方式变化、expo-av 向 expo-audio 与 expo-video 的迁移,以及 @react-navigation/ 导入迁移到 expo-router 入口等内容,并以 reference 文档形式分项列出。

使用方式: 指南给出逐步升级命令:先用 npx expo install expo@latest 安装最新 Expo,再用 npx expo install --fix 修正依赖,随后运行 npx expo-doctor 诊断,并通过 npx expo export -p ios --clear、删除 node_modules 与 .expo、执行 watchman watch-del-all 清理缓存后重新安装。若存在原生工程目录且升级需要原生改动,可运行 npx expo prebuild --clean 重新生成 ios 与 android 目录,并分别清理 CocoaPods、Xcode 派生数据与 Gradle 缓存。若要安装 beta 版本,可使用 .preview 后缀并发布在 @next 标签下,通过 npx expo install expo@next --fix 安装。

版本注意事项: 指南提示,从 SDK 55 或更早版本升级时应跳过 SDK 56,直接升级到 SDK 57,且不要使用 expo@57.0.8 或更低版本;SDK 55 启用 Hermes V1、SDK 56 以及较早的 SDK 57 版本在使用 react-native-worklets 或 react-native-reanimated 时存在内存回归问题。Hermes V1 在 SDK 56 及以后默认为默认引擎,不建议引导用户切换 Hermes 版本。新架构默认启用,app.json 中的 "newArchEnabled": true 不再必要,自 SDK 53 起 Expo Go 仅支持新架构。

项目清理与废弃包: 指南建议检查 app.json 中的 expo.install.exclude 排除项、清理 patches 目录中不再需要的补丁、在 SDK 53 及以后移除 autoprefixer 并使用 postcss.config.mjs、删除冗余 Metro 配置项(如 resolver.unstable_enablePackageExports、experimentalImportSupport、EXPO_USE_FAST_RESOLVER 等默认或已移除的选项),并指出 Expo webpack 已废弃,应迁移到 Expo Router 与 Metro web。废弃包替换表列出 expo-av 替换为 expo-audio 与 expo-video、expo-permissions 替换为各包独立权限 API、@expo/vector-icons 替换为 expo-symbols、AsyncStorage 替换为 expo-sqlite/localStorage/install、expo-app-loading 替换为 expo-splash-screen、expo-linear-gradient 替换为实验性 backgroundImage 与 CSS 渐变等。删除依赖后应立即重新运行 expo-doctor 并恢复其报告的缺失必需 peer 依赖。

适用场景与限制: 适用于维护 Expo 应用的开发者在跨 SDK 大版本升级、依赖冲突排查、废弃 API 迁移与原生工程重建时参考。内容是操作指南而非自动化工具,具体项目效果取决于实际情况;部分条目(如 beta 版本判断、反馈提交命令)需要联网或特定环境执行。资料未提供收费、价格与平台支持等其他信息。

反馈: 如遇错误或过时信息,可使用 npx --yes submit-expo-feedback@latest --category skills --subject "expo-upgrade" "<actionable feedback>" 提交反馈;若 AI 代理反复失败,应加载 expo-skill-feedback 技能并按 eval-candidate 流程处理。