开始使用 EAS 更新

安装最新的 EAS CLI

🌐 Install the latest EAS CLI

EAS CLI 是一个命令行应用，你可以通过终端使用它与 EAS 服务进行交互。要安装它，请运行以下命令：

🌐 EAS CLI is the command line app you will use to interact with EAS services from your terminal. To install it, run the command:

你也可以使用上述命令来检查是否有新的 EAS CLI 版本可用。我们鼓励你始终保持最新版本。

🌐 You can also use the above command to check if a new version of EAS CLI is available. We encourage you to always stay up to date with the latest version.

我们建议在进行全局包安装时使用 npm 而不是 yarn。你也可以选择使用 npx eas-cli@latest。记住，每当文档中要求使用 eas 时，应使用它替代。

登录到你的 Expo 账户

🌐 Log in to your Expo account

如果你已经使用 Expo CLI 登录了 Expo 账号，可以跳过本节中描述的步骤。如果你还没有登录，请运行以下命令进行登录：

🌐 If you are already signed in to an Expo account using Expo CLI, you can skip the steps described in this section. If you are not, run the following command to log in:

你可以通过运行 eas whoami 来检查你是否已登录。

🌐 You can check whether you are logged in by running eas whoami.

配置你的项目

🌐 Configure your project

在终端中导航到你的项目目录并运行以下命令：

🌐 Navigate to your project directory in your terminal and run the following command:

<meta-data android:name="expo.modules.updates.EXPO_UPDATE_URL" android:value="https://u.expo.dev/your-project-id"/>
<meta-data android:name="expo.modules.updates.EXPO_RUNTIME_VERSION" android:value="@string/expo_runtime_version"/>

<key>EXUpdatesRuntimeVersion</key>
<string>1.0.0</string>
<key>EXUpdatesURL</key>
<string>https://u.expo.dev/your-project-id</string>

Configure the update channel

The channel property on a build allows you to point updates at specific types of builds. For example, it allows you to publish updates to a preview build without impacting your production deployment.

If you are using EAS Build, eas update:configure will set the update channel property on the preview and production profiles in eas.json. Set them manually if you use different profile names.

{
  "build": {
    "preview": {
      "channel": "preview"
      // ...
    },
    "production": {
      "channel": "production"
      // ...
    }
  }
}

If you are not using EAS Build, then you will need to configure the channel in app.json or in your native projects, depending on whether you use CNG. When you create a build for a different environment, you will need to modify the channel to ensure your build pulls updates from the correct channel. Learn more using EAS Update as a standalone service.

{
  "expo": {
    %%placeholder-start%%... %%placeholder-end%%
    "updates": {
      %%placeholder-start%%... %%placeholder-end%%
      "requestHeaders": {
        "expo-channel-name": "your-channel-name"
      }
      %%placeholder-start%%... %%placeholder-end%%
    }
    %%placeholder-start%%... %%placeholder-end%%
  }
}

<meta-data android:name="expo.modules.updates.UPDATES_CONFIGURATION_REQUEST_HEADERS_KEY" android:value="{&quot;expo-channel-name&quot;:&quot;your-channel-name&quot;}"/>

<key>EXUpdatesRequestHeaders</key>
<dict>
  <key>expo-channel-name</key>
  <string>your-channel-name</string>
</dict>

Create a build for the project

You need to create a build for Android or iOS. We recommend creating a build with the preview build profile first. See Create your first build on how to get started and set up Internal distribution for your device or simulator.

Once you have a build running on your device or a simulator, you are ready to send an update.

Make changes locally

After creating the build, you are ready to iterate on the project. Start a local development server with the following command:

Then, make any desired changes to your project's JavaScript, styling, or image assets.

Publish an update

Publishing an update allows:

• Fixing bugs and quickly updating non-native parts of a project instead of creating a new build
• Sharing a preview version of an app using internal distribution

To publish an update with changes from your project, use the eas update command, and specify a name for the channel, a message to describe the update and if using EAS environment variables, the environment pull variables from (leave unspecified to use the .env files present in your project directory):

测试更新

🌐 Test the update

在将更新上传到 EAS 更新后，你可以使用以下方法之一来测试更新：

🌐 After the update is uploaded to EAS Update, you can use one of the following methods to test the update:

• 在开发版本中使用扩展选项卡来加载更新。
• 使用 Expo Orbit 在开发版本中安装并启动更新。
• 使用 Updates API 和 应用配置 实现自定义策略，以在应用中以编程方式加载更新。
• 通过强制关闭并重新打开你的应用的发布版本最多两次来手动测试更新，以下载并应用更新。非开发版本（预览版或正式版）的更新会在应用启动并请求任何新更新时自动下载到设备后台。下载完成后，更新将在应用重新启动时应用。