如何无痛升级Expo SDKExpo Skills的expo-upgrade依赖冲突与废弃包迁移清单【免费下载链接】skillsA collection of AI agent skills for working with Expo projects and Expo Application Services项目地址: https://gitcode.com/gh_mirrors/skills9/skills升级 Expo SDK 版本常常是 React Native 开发者的噩梦依赖冲突接踵而至、废弃包如 expo-av需要迁移、缓存没清干净还会引发各种神秘报错。本文带你使用 Expo 官方 AI Agent 技能集合Expo Skills中的expo-upgrade技能系统讲解 Expo SDK 升级三步流程、依赖冲突解决方法与完整废弃包迁移清单帮你把升级变成一件无痛的事 什么是 expo-upgrade专为Expo SDK升级设计的AI技能expo-upgrade 是 Expo 团队官方维护的开源技能安装在 AI 编程助手如 Claude、Codex中后它会像一位资深工程师一样引导你完成版本升级自动检查依赖、修复冲突、迁移废弃包、清理缓存。技能主文件位于 plugins/expo/skills/expo-upgrade/SKILL.md并配有 7 份分场景迁移参考文档存放在 references/ 目录下。三步无痛升级最快Expo SDK升级命令序列整个升级过程只需要三步命令这也是技能中给出的标准流程npx expo install expolatest # 1. 升级 Expo 及全部依赖 npx expo install --fix # 2. 自动修复依赖冲突 npx expo-doctor # 3. 运行体检诊断第 1 步npx expo install expolatest负责升级核心 SDK第 2 步npx expo install --fix是解决依赖冲突的关键它会自动把版本不匹配的包修正到兼容版本第 3 步npx expo-doctor像医生体检一样检查缺失的 peer 依赖、配置错误等问题。 如果升级涉及原生改动且项目存在ios/或android/目录记得执行npx expo prebuild --clean重新生成原生工程纯 CNG持续原生生成项目可以跳过这一步。依赖冲突怎么解决expo-upgrade的三大技巧1. 用 expo-doctor 定位缺失依赖移除任何依赖包之后立即运行npx expo-doctor把报告中缺失的必需 peer 依赖补回来——这是技能反复强调的黄金习惯。2. 检查 expo.install.exclude 排除项SKILL.md 提醒package.json里expo.install.exclude中的包如react-native-reanimated往往是过去的临时妥协升级后可能已经不再需要建议逐个复查。3. 清理过期补丁与冗余配置检查patches/目录删除不再需要的补丁若babel.config.js只包含babel-preset-expo、metro.config.js只有 Expo 默认配置可以直接删除文件保留expo-constants作为直接依赖装了 expo-router 时避免原生自动链接在 Expo Go 外失效。废弃包迁移清单一份完整对照表这是 expo-upgrade 技能中最实用的部分——官方维护的废弃包迁移对照表原文见 SKILL.md 第90-99行旧包废弃替代方案expo-avexpo-audioexpo-videoexpo-permissions各功能包内置的权限 APIexpo/vector-iconsexpo-symbolsSF SymbolsAsyncStorageexpo-sqlite/localStorage/installexpo-app-loadingexpo-splash-screenexpo-linear-gradientCSS 渐变 experimental_backgroundImage其中expo-av 的拆分最值得注意SDK 55 起音视频能力拆分为两个独立包 音频Audio.Sound→useAudioPlayerAudio.Recording→useAudioRecorder详细 API 对照见 expo-av-to-audio.md 视频Video→VideoViewuseVideoPlayer详细 API 对照见 expo-av-to-video.md⚠️ 重要提示在 Android 上expo-av 和 expo-video 同时安装会导致视频黑屏请先卸载 expo-av 再安装 expo-video。按版本看重大变化SDK 53 到 SDK 56 各改了什么SDK 53新架构默认开启新架构New Architecture默认启用newArchEnabled: true配置项不再需要Expo Go 也只支持新架构旧架构 App 必须改用开发构建。详见 new-architecture.md。SDK 54React 19 与 React CompileruseContext→useContext.Provider→ContextforwardRef可整体删除React Compiler 已稳定在app.json中加入reactCompiler: true即可自动记忆化告别手写useMemo/useCallback。对照文档react-19.md、react-compiler.md。SDK 55Native Tabs 写法变更Icon、Label、Badge不再是独立导入改为通过NativeTabs.Trigger.*静态属性访问。迁移步骤见 native-tabs.md。SDK 56react-navigation 导入路径迁移应用代码不能再直接导入react-navigation/*需改为对应的expo-router入口运行时 API 不变。官方提供 codemod 一键批量改写npx expo-codemod sdk-56-expo-router-react-navigation-replace src完整导入映射表见 react-navigation-to-expo-router.md。升级后收尾检查清单阅读目标 SDK 的 release notes确认被移除的 API测试相机、音频、视频功能是否全部正常验证导航Navigation仍工作正常SDK 54 确认已安装react-native-workletsreanimated 的必需依赖;删除app.json中的sdkVersion让 Expo 自动管理版本原生缓存清理iOS 执行pod install --repo-updateAndroid 执行./gradlew clean。升级时最容易踩的3个坑跳过 SDK 56 直升 57SDK 55开启 Hermes V1 时、整个 SDK 56 及部分早期 SDK 57 版本存在 Hermes V1 内存回归问题会显著推高使用react-native-reanimated时的内存占用。技能的建议是从 SDK 55 或更早版本直接跳到 SDK 57 的expo57.0.9及以上。不要手动开关 Hermes V1从 SDK 默认值改动 Hermes 版本是不受支持的操作会有严重的构建与依赖管理坑。别删expo-av就装expo-video顺序反了在 Android 上会出现黑屏见上文提示。相关模块路径速查内容相对路径升级主技能含废弃包清单plugins/expo/skills/expo-upgrade/SKILL.md音频迁移指南plugins/expo/skills/expo-upgrade/references/expo-av-to-audio.md视频迁移指南plugins/expo/skills/expo-upgrade/references/expo-av-to-video.md新架构迁移plugins/expo/skills/expo-upgrade/references/new-architecture.mdReact 19 变更plugins/expo/skills/expo-upgrade/references/react-19.mdReact Compilerplugins/expo/skills/expo-upgrade/references/react-compiler.mdNative Tabs 迁移plugins/expo/skills/expo-upgrade/references/native-tabs.md路由迁移codemod 说明plugins/expo/skills/expo-upgrade/references/react-navigation-to-expo-router.md下次升级 Expo SDK 时只需对 AI 助手说帮我升级 Expo SDKexpo-upgrade 技能就会带着你按这份清单一步步走完全程 【免费下载链接】skillsA collection of AI agent skills for working with Expo projects and Expo Application Services项目地址: https://gitcode.com/gh_mirrors/skills9/skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考