SuperAPI AI 工具集

expo-upgrading-v55

通用与其它

查看项目

更新于 10-15 17:27

技能介绍

用途:该技能提供将 Expo 应用升级到 SDK 57 的操作指南与依赖问题修复方法,同时覆盖多个版本累积的破坏性变更。文中名称含 v55,实际内容以升级到 SDK 57 为主。

主要能力:包含 React 19 变更(useContext 改为 use、Context.Provider 改为 Context、移除 forwardRef)、新架构迁移、React Compiler 配置、原生 Tabs(Icon/Label/Badge 改为经 NativeTabs.Trigger.* 访问)、expo-av 到 expo-audio 与 expo-video 的迁移、@react-navigation/* 迁移到 expo-router 等参考文档。

使用方式:从 SDK 55 或更早升级时跳过 SDK 56 直接升到 SDK 57,不要使用 expo@57.0.8 或更低版本。基本命令为 npx expo install expo@latest、npx expo install --fix,再运行 npx expo-doctor;如需原生改动执行 npx expo prebuild --clean。裸工作流需清缓存:cd ios && pod install --repo-update、npx expo run:ios --no-build-cache、cd android && ./gradlew clean。测试版可用 npx expo install expo@next --fix。

适用场景与限制:适用于 Expo/React Native 项目升级与依赖清理(删除 sdkVersion、移除隐式包、清理 metro 与 babel 配置等)。若项目无 ios/ 与 android/ 目录则为 CNG,可跳过 prebuild 与裸工作流清缓存部分。Hermes V1 在 SDK 56 及以后为默认,不要引导用户切换 Hermes 版本;Worklets Bundle Mode 不受支持,不作为生产替代方案。资料未提供收费与平台信息。