升级 Expo SDK

编辑

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


我们建议逐步升级 SDK 版本,逐个进行。这样可以帮助你精准定位在升级过程中出现的故障和问题。

随着新的 SDK 发布,最新版本进入当前发布状态。这适用于 Expo Go,因为它只支持最新的 SDK 版本,而之前的版本不再受到支持。我们建议对生产应用使用 开发版本,因为在 EAS 服务上,较旧 SDK 版本的向后兼容性往往更长,但不是永久的。

如果你希望安装特定版本的 Expo Go,请访问 expo.dev/go。它支持 Android 设备/模拟器和 iOS 模拟器的下载。然而,由于 iOS 平台的限制,只有最新版本的 Expo Go 可用于实际的 iOS 设备安装。

如何升级到最新的 SDK 版本

1

升级 Expo SDK

安装新的 Expo 包版本:

Terminal
npm install expo@^54.0.0
Terminal
yarn add expo@^54.0.0
Terminal
pnpm add expo@^54.0.0
Terminal
bun install expo@^54.0.0

根据你要升级的 SDK,替换 expo@^54.0.0 为你所针对的 Expo SDK 版本范围。例如,expo@^54.0.0 代表 SDK 54。

2

升级依赖项

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

Terminal
npx expo install --fix

npx expo-doctor

3

更新原生项目

  • 如果你使用 持续原生生成: 如果你为以前的 SDK 版本在本地项目目录中生成了 androidios 目录,请删除它们。下次你运行构建时,它们将被重新生成,无论是使用 npx expo run:iosnpx expo prebuild,还是使用 EAS Build。
  • 如果你不使用 持续原生生成: 如果你有 ios 目录,请运行 npx pod-install。应用来自 原生项目升级助手 的任何相关更改。或者,你可以考虑 采用 prebuild 以便将来更轻松地升级。

4

根据发布说明遵循其他说明

阅读你要升级的 SDK 版本的 SDK 变更日志。其中包含有关重大更改、弃用和可能影响你应用的其他更改的重要信息。请参阅发布说明页面底部的“升级你的应用”部分以获取任何附加说明。

SDK 变更日志

每个 SDK 公告发布说明帖子包含有关弃用、重大更改以及可能特定于该 SDK 版本的其他信息。在升级时,请务必查看这些内容,以确保你不会遗漏任何内容。

已弃用 SDK 版本变更日志

以下博客文章可能包含过时信息,但如果你在 SDK 升级方面落后,这些信息仍然有参考价值。

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