Docs
博客更新日志GitHub简中文档
首页指南EAS参考学习
存档Expo SnackDiscord 和论坛新闻邮件

升级 Expo SDK

编辑页面

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

For the complete documentation index, see llms.txt. Use this Use this file to discover all available pages.

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

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

如果你想安装特定版本的 Expo Go，请访问 expo.dev/go。它支持 Android 设备/模拟器以及 iOS 模拟器的下载。不过，由于 iOS 平台限制，物理 iOS 设备上只能安装最新版本的 Expo Go。

如何升级到最新的 SDK 版本

1

升级 Expo SDK

安装 Expo 包的新版本：

Terminal
- npm install expo@^55.0.0

根据你要升级到的 SDK 版本，将 expo@^55.0.0 替换为你目标 Expo SDK 版本的版本范围。例如，expo@^55.0.0 代表 SDK 55。

2

升级依赖项

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

Terminal
- npx expo install --fix

- npx expo-doctor

3

更新原生项目

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

4

关注发布说明中的其他说明

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

SDK Changelogs

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

已弃用的 SDK 版本变更日志

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

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