This documentation is available as Markdown for AI agents and LLMs. See the full Markdown index or append .md to any documentation URL.
升级 Expo SDK
编辑页面
了解如何在你的项目中逐步升级 Expo SDK 版本。
信息 我们建议一次只逐步升级一个 SDK 版本。这样做将有助于你找出升级过程中出现的破坏性变更和问题。
随着新 SDK 版本的发布，最新版本会进入当前发布状态。这也适用于 Expo Go，因为它只支持最新的 SDK 版本，且不再支持之前的版本。我们建议生产应用使用开发构建，因为 EAS 服务上较旧 SDK 版本的向后兼容性通常会长得多，但不会永远如此。
如果你想在 Android 设备、Android Emulator 或 iOS Simulator 上安装特定版本的 Expo Go，请访问 expo.dev/go 或使用 expo-go CLI。如需了解更多信息，请参阅排查 Expo Go 版本不匹配问题。
如何升级到最新的 SDK 版本
使用 AI 编码代理升级
如果你使用 AI 编码代理，请安装 Expo Skills 并使用 expo-upgrade skill。该 skill 提供了升级 Expo SDK 版本和修复依赖问题的指导。请审查任何建议的更改，并查看 SDK 变更日志以获取特定版本的说明。
Guidelines for upgrading Expo SDK versions and fixing dependency issues.
手动升级
1
2
3
更新原生项目
- 如果你使用 Continuous Native Generation：如果你在本地项目目录中为之前的 SDK 版本生成过 android 和 ios 目录，请删除它们。下次你运行构建时，它们会被重新生成，无论是使用
npx expo run:ios、npx expo prebuild，还是使用 EAS Build。 - 如果你不使用 Continuous Native Generation：如果你有一个 ios 目录，请运行
npx pod-install。应用原生项目升级助手中的任何相关更改。或者，你也可以考虑采用 prebuild，以便将来更轻松地升级。
4
遵循发布说明中的任何其他说明
阅读你正在升级到的 SDK 版本的 SDK 变更日志。它们包含有关破坏性变更、弃用以及其他可能影响你应用的重要信息。请参阅发布说明页面底部的“升级你的应用”部分，了解任何额外说明。
SDK 变更日志
每个 SDK 公告的发布说明文章都包含有关弃用、破坏性变更以及该特定 SDK 版本可能独有的其他内容的信息。升级时，请务必查看这些内容，以确保不会遗漏任何信息。
已弃用的 SDK 版本变更日志
以下博客文章可能包含过时信息，但如果你恰好在 SDK 升级上落后很多，它们仍然可供参考。