Edit this page
Learn how to incrementally upgrade the Expo SDK version in your project.
We recommend upgrading SDK versions incrementally, one at a time. Doing so will help you pinpoint breakages and issues that arise during the upgrade process.
With a new SDK release, the latest version enters the current release status. This applies to Expo Go as it only supports the latest SDK version and previous versions are no longer supported. We recommend using development builds for production apps as the backwards compatibility for older SDK versions on EAS services tends to be much longer, but not forever.
If you are looking to install a specific version of Expo Go, visit expo.dev/go. It supports downloads for Android devices/emulators and iOS simulators. However, due to iOS platform restrictions, only the latest version of Expo Go is available for installation on physical iOS devices.
1
Install the new version of the Expo package:
# Install latest
-
npx expo install expo@latest
# Install a specific SDK version (for example, SDK 52)
-
npx expo install expo@^52.0.0
# Install latest
-
yarn expo install expo@latest
# Install a specific SDK version (for example, SDK 52)
-
yarn expo install expo@^52.0.0
2
Upgrade all dependencies to match the installed SDK version.
-
npx expo install --fix
3
npx expo run:ios
, npx expo prebuild
, or with EAS Build.npx pod-install
if you have an ios
directory. Apply any relevant changes from the Native project upgrade helper. Alternatively, you could consider adopting prebuild for easier upgrades in the future.4
Read the SDK changelogs for the SDK version you are upgrading to. They contain important information about breaking changes, deprecations, and other changes that may affect your app. Refer to tue "Upgrading your app" section at the bottom of the release notes page for any additional instructions.
Each SDK announcement release notes post contains information deprecations, breaking changes, and anything else that might be unique to that particular SDK version. When upgrading, be sure to check these out to make sure you don't miss anything.
The following blog posts may included outdated information, but they are still useful for reference if you happen to fall far behind on SDK upgrades.