"“项目与此版本的 Expo Go 不兼容”错误

编辑页面

了解为什么 Expo 项目与已安装的 Expo Go 版本不兼容，以及如何安装兼容的版本

当项目中的 Expo SDK 版本与已安装的 Expo Go 应用中包含的 SDK 版本不匹配时，Expo Go 会显示此错误：

Project is incompatible with this version of Expo Go

你还可能会看到以下消息之一：

The project you requested requires a newer version of Expo Go.
This project requires a newer version of Expo Go.

为什么会发生这种情况

每个 Expo Go 构建版本都包含一个 Expo SDK 版本。package.json 中的 expo 软件包版本决定了项目的 SDK 版本。项目和 Expo Go 的 SDK 版本必须匹配。

Apple App Store 中的 Expo Go 最高支持 SDK 54，SDK 55 及更高版本无法在其中使用。Google Play 版本也可能落后于新的 SDK 版本发布。如果你的项目使用的 SDK 比应用商店中的构建版本更新，请使用以下选项之一，而不是等待应用商店更新。

安装兼容的 Expo Go 版本

根据测试项目的设备，使用相应的说明。

实体 iPhone 或 iPad

对于使用 SDK 54 或更高版本的项目，请使用 eas go 构建 Expo Go，并通过你的 TestFlight 内部团队进行分发；这需要加入 Apple Developer Program。对于使用 SDK 54 的项目，你也可以从 Apple App Store 安装 Expo Go。

对于使用 SDK 53 或更早版本的项目，无法在实体 iOS 设备上安装旧版本的 Expo Go。升级项目、使用 Android 设备或 iOS Simulator，或者创建 development build。

Android 设备、Android Emulator 或 iOS Simulator

访问 expo.dev/go，选择项目使用的 SDK 版本和目标平台，然后安装兼容的 Expo Go 构建版本。

你还可以使用 expo-go CLI 下载特定版本。

安装兼容的构建版本后，使用 npx expo start 重启开发服务器，然后重新打开项目。

检查项目的 SDK 版本

如果安装正确的 Expo Go 构建版本后错误仍然存在：

检查 package.json 中的 expo 依赖项，确认项目的 SDK 版本。
如果你的 app config 包含 sdkVersion 字段，请将其删除，或确保其与 expo 依赖项匹配。
运行 npx expo-doctor@latest 检查依赖项版本问题。
运行 npx expo install --fix，使软件包版本与已安装的 Expo SDK 保持一致。

升级项目或使用 development build

你可以将项目升级到更新的 Expo SDK，而不是安装其他版本的 Expo Go。

Expo Go 是一个学习环境和沙盒。对于生产项目，请创建 development build，这样原生应用及其依赖项就由你的项目控制。