开始使用 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。

¥We recommend using npm instead of yarn for global package installations. You may alternatively use npx eas-cli@latest. Remember to use that instead of eas whenever it's called for in the documentation.

登录你的 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.

如果你使用 EAS Build，eas update:configure 将在 eas.json 中的 preview 和 production 配置文件上设置更新 channel 属性。如果你使用不同的配置文件名称，请手动设置它们。

¥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"
    // ...
  }
}
}

如果你不使用 EAS Build，则需要在 app.json 或原生项目中配置渠道，具体取决于你是否使用 CNG。当你为不同的环境创建构建时，你需要修改渠道以确保你的构建从正确的渠道提取更新。使用 EAS 更新作为独立服务 了解更多信息。

¥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

你需要创建适用于 Android 或 iOS 的版本。我们建议首先使用 preview 构建配置文件创建构建。请参阅 创建你的第一个版本，了解如何开始使用并为你的设备或模拟器设置 内部分发。

¥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:

然后，对项目的 JavaScript、样式或图片资源进行所需的更改。

¥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

要发布包含项目更改的更新，请使用 eas update 命令，并指定通道名称和 message 来描述更新：

¥To publish an update with changes from your project, use the eas update command, and specify a name for the channel and a message to describe the update:

测试本地

¥Test the update

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

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

• 使用 开发构建 中的扩展选项卡加载更新。

  ¥Use the Extensions tab in a development build to load the update.

• 使用 Expo 轨道 在开发版本中安装和启动更新。

  ¥Use Expo Orbit to install and launch the update in a development build.

• 使用 更新 API 和 应用配置 实现自定义策略，以编程方式在应用中加载更新。

  ¥Implement a custom strategy with Updates API and app config to load updates in the app programmatically.

• 通过强制关闭并重新打开应用的发布版本最多两次来下载和应用更新，手动测试更新。当应用启动并请求任何新更新时，非开发版本（预览或生产）的更新会在后台自动下载到设备。下载更新并重新启动应用后，将应用更新。

  ¥Manually test the update by force closing and reopening a release build of your app up to two times to download and apply the update. Updates for non-development builds (preview or production) are automatically downloaded to the device in the background when the app starts up and makes a request for any new updates. The update will be applied after it is downloaded and the app is restarted.