升级 Expo SDK

编辑页面

了解如何在你的项目中逐步升级 Expo SDK 版本。

信息我们建议一次只逐步升级一个 SDK 版本。这样做将有助于你找出升级过程中出现的破坏性变更和问题。

随着新 SDK 版本的发布，最新版本会进入当前发布状态。这也适用于 Expo Go，因为它只支持最新的 SDK 版本，且不再支持之前的版本。我们建议生产应用使用开发构建，因为 EAS 服务上较旧 SDK 版本的向后兼容性通常会长得多，但不会永远如此。

如果你正在寻找安装特定版本的 Expo Go，请访问 expo.dev/go 或使用 expo-go CLI。它支持为 Android 设备/模拟器和 iOS 模拟器下载。不过，由于 iOS 平台限制，只有最新版本的 Expo Go 可安装到物理 iOS 设备上。

如何升级到最新的 SDK 版本

如果你使用 AI 编码代理，请安装 Expo Skills 并使用 expo-upgrade skill。该 skill 提供了升级 Expo SDK 版本和修复依赖问题的指导。请审查任何建议的更改，并查看 SDK 变更日志以获取特定版本的说明。

Guidelines for upgrading Expo SDK versions and fixing dependency issues.

安装 Expo 包的新版本：

Terminal

- npm install expo@^57.0.0

取决于你要升级到的 SDK 版本，请将 expo@^57.0.0 替换为你目标 Expo SDK 版本对应的版本范围。例如，expo@^57.0.0 代表 SDK 57。

升级所有依赖项以匹配已安装的 SDK 版本。然后运行 expo-doctor 命令来检查常见问题。

Terminal

- npx expo install --fix

- npx expo-doctor

如果你使用 Continuous Native Generation：如果你在本地项目目录中为之前的 SDK 版本生成过 android 和 ios 目录，请删除它们。下次你运行构建时，它们会被重新生成，无论是使用 npx expo run:ios、npx expo prebuild，还是使用 EAS Build。
如果你不使用 Continuous Native Generation：如果你有一个 ios 目录，请运行 npx pod-install。应用原生项目升级助手中的任何相关更改。或者，你也可以考虑采用采用 prebuild，以便将来更轻松地升级。

阅读你正在升级到的 SDK 版本的 SDK 变更日志。它们包含有关破坏性变更、弃用以及其他可能影响你应用的重要信息。请参阅发布说明页面底部的“升级你的应用”部分，了解任何额外说明。

每个 SDK 公告的发布说明文章都包含有关弃用、破坏性变更以及该特定 SDK 版本可能独有的其他内容的信息。升级时，请务必查看这些内容，以确保不会遗漏任何信息。

以下博客文章可能包含过时信息，但如果你恰好在 SDK 升级上落后很多，它们仍然可供参考。

查看已弃用的 SDK 发布变更日志完整列表