SuperAPI AI 工具集

expo-upgrading-v55

通用与其它

查看项目

更新于 10-15 17:27

技能介绍

用途:为该仓库提供 Expo SDK 版本升级与依赖问题修复的指导性参考,属于升级操作手册类技能,不包含可执行代码库本身。

主要能力与参考文档:技能内含多份参考文件,分别覆盖不同 SDK 版本的升级要点:new-architecture.md 对应 SDK 53 的新架构迁移;react-19.md 与 react-compiler.md 对应 SDK 54 的 React 19 变更和 React Compiler 配置迁移;native-tabs.md 对应 SDK 55 中通过 NativeTabs.Trigger.* 访问 Icon/Label/Badge 的变更;expo-av-to-audio.md 与 expo-av-to-video.md 说明从 expo-av 迁移到 expo-audio、expo-video 的方式。

使用方式:升级流程建议先执行 npx expo install expo@latest,再执行 npx expo install --fix,随后运行 npx expo-doctor 诊断。Beta 版本使用 .preview 后缀并以 @next 标签发布,可通过 npx expo install expo@next --fix 安装。清理缓存与重装涉及 npx expo export -p ios --clear、rm -rf node_modules .expo 与 watchman watch-del-all。需要原生变更时使用 npx expo prebuild --clean;仅在项目存在 ios/ 或 android/ 目录时,才需执行 cd ios && pod install --repo-update、npx expo run:ios --no-build-cache、cd android && ./gradlew clean。

适用场景:处理 SDK 53 至 55 的破坏性变更、导入路径调整、废弃包替换(如 expo-av 到 expo-audio/expo-video、expo-permissions、@expo/vector-icons、AsyncStorage、expo-app-loading、expo-linear-gradient)、expo.install.exclude 与 patches 清理、postcss 与 Metro 冗余配置移除等。

限制:文中未提供具体版本兼容矩阵、各参考文件全文内容及性能或成功率的量化说明;Hermes v1 为选入特性,需在 expo-build-properties 中设置 useHermesV1: true,且可能依赖特定版本的 hermes-compiler,未来 SDK 才会默认启用。