构建服务器基础设施

了解使用 EAS 时当前的构建服务器基础设施。

For the complete documentation index, see llms.txt. Use this file to discover all available pages.

生成器 IP 地址

🌐 Builder IP addresses

构建服务器的 IP 地址列表可以在此文件中找到。我们不预期会经常更改该列表。列表中包含“Last-Modified”和“Expires” ISO 8601 时间戳，分别指示列表最后一次更新的时间以及我们承诺在此之前不更改列表的时间。

🌐 A list of the IP addresses of the build servers is available in this file. We do not expect to change the list often. The list includes "Last-Modified" and "Expires" ISO 8601 timestamps that respectively specify the last time the list was updated and the time until which we commit to not change the list.

Linux 运行器托管在谷歌云平台。macOS 运行器托管在我们自己的 macOS 云中。

🌐 Linux runners are hosted in Google Cloud Platform. macOS runners are hosted in our own macOS cloud.

配置构建环境

🌐 Configuring build environment

每个平台的镜像都有特定版本的 Node.js、Yarn、CocoaPods、Xcode、Ruby、Fastlane 等。你可以在 eas.json 中覆盖部分版本。如果没有你需要的专用配置选项，你可以使用 npm hooks 来使用 apt-get 或 brew 安装或更新任何系统依赖。请注意，这些自定义将在构建过程中应用，并会增加你的构建时间。

🌐 Images for each platform have one specific version of Node.js, Yarn, CocoaPods, Xcode, Ruby, Fastlane, and so on. You can override some of the versions in eas.json. If there is no dedicated configuration option you are looking for, you can use npm hooks to install or update any system dependencies with apt-get or brew. Consider that those customizations are applied during the build and will increase your build times.

在为构建选择镜像时，你可以使用下面提供的全名，或者使用其中一个别名：auto、latest，或针对特定 SDK 使用 sdk-55。

🌐 When selecting an image for the build you can use the full name provided below or one of the aliases: auto, latest, or for a particular SDK such as sdk-55.

• 使用特定名称可保证环境一致，只需进行少量更新。
• 使用 auto 别名时，构建镜像将根据项目配置、Expo SDK 版本和 React Native 版本进行选择。你可以在 启动构建环境 构建日志部分查看构建使用的镜像。
• latest 别名将分配给拥有最新软件版本的镜像。
• sdk-55 别名将分配给最适合 SDK 55 构建的镜像。
• sdk-54 别名将分配给最适合 SDK 54 构建的镜像。
• sdk-53 别名将分配给最适合 SDK 53 构建的镜像。
• sdk-52 别名将分配给最适合 SDK 52 构建的镜像。
• SDK 别名将随着每个新的 SDK 版本更新。
• latest 别名将在每次新镜像发布时更新。

信息 注意： 如果你在 eas.json 中没有提供 image，你的构建将默认使用 auto 别名。

Android 构建服务器配置

🌐 Android build server configurations

Android 构建器在隔离环境中的虚拟机上运行。每次构建都会获得自己的专用虚拟机实例。

🌐 Android builders run on virtual machines in an isolated environment. Every build gets its own dedicated VM instance.

• 构建资源：

  • medium: 4 vCPUs, 16 GB RAM (n2-standard-4 or c3d-standard-4 (default) Google Cloud machine type, depending on the "New Android Builds Infrastructure" setting in project settings)
  • large: 8 vCPUs, 32 GB RAM (n2-standard-8 or c3d-standard-8 (default) Google Cloud machine type, depending on the "New Android Builds Infrastructure" setting in project settings)

• 使用 Kubernetes 部署的 npm 缓存

• 使用 Kubernetes 部署的 Maven 缓存

• 当构建环境被配置时，Gradle JVM 参数通过 GRADLE_OPTS 环境变量注入。请参见下面的 Gradle JVM 参数。

• 全局 npm 配置在 ~/.npmrc 中：

  ~/.npmrc

  Copy

  registry=http://npm.production.caches.eas-build.internal
  

• 全局 Yarn 配置在 ~/.yarnrc.yml 中：

  ~/.yarnrc.yml

  Copy

  unsafeHttpWhitelist:
    - '*'
  npmRegistryServer: 'http://npm.production.caches.eas-build.internal'
  enableImmutableInstalls: false
  

Gradle JVM 参数

🌐 Gradle JVM args

EAS Build 会在 Gradle 运行之前在构建虚拟机（worker）上设置 GRADLE_OPTS 环境变量。其值取决于你选择的 资源类别 ：

🌐 EAS Build sets the GRADLE_OPTS environment variable on the build VM (the worker) before Gradle runs. The values depend on the resource class you select:

除了 -Xmx，该工作者还通过 -Dorg.gradle.jvmargs 将以下 JVM 参数传递给 Gradle 构建 JVM：

🌐 In addition to -Xmx, the worker passes the following JVM args to the Gradle build JVM via -Dorg.gradle.jvmargs:

• -XX:MaxMetaspaceSize=1g
• -XX:+HeapDumpOnOutOfMemoryError
• -Dfile.encoding=UTF-8

该工作者还在 GRADLE_OPTS 上设置这些顶层 Gradle 属性：

🌐 The worker also sets these top-level Gradle properties on GRADLE_OPTS:

• -Dorg.gradle.parallel=true
• -Dorg.gradle.daemon=false

警告 工作线程通过 GRADLE_OPTS 设置 org.gradle.jvmargs，这会覆盖你项目的 gradle.properties 中定义的任何 org.gradle.jvmargs。

覆盖 GRADLE_OPTS

🌐 Overriding GRADLE_OPTS

你可以通过在 eas.json 中的构建配置文件的 env 下设置 GRADLE_OPTS，在 工作流文件 中，或使用 EAS 环境变量 来替换工作节点默认值。项目环境值优先于工作节点的默认值。

🌐 You can replace the worker default by setting GRADLE_OPTS under a build profile's env in eas.json, in a workflow file, or with EAS Environment Variables. Project environment values take precedence over the worker's default values.

Android 服务器镜像

🌐 Android server images

ubuntu-24.04-jdk-17-ndk-r27b-sdk-55 (latest, sdk-55)

ubuntu-24.04-jdk-17-ndk-r27b (sdk-54)

ubuntu-22.04-jdk-17-ndk-r26b (sdk-53)

类似ubuntu-22.04-jdk-17-ndk-r26b的遗留 （sdk-51，sdk-52）

🌐 Legacy ubuntu-22.04-jdk-17-ndk-r26b-like (sdk-51, sdk-52)

ubuntu-22.04-jdk-17-ndk-r25b (sdk-50)

ubuntu-22.04-jdk-11-ndk-r23b (sdk-49)

ubuntu-22.04-jdk-17-ndk-r21e

ubuntu-22.04-jdk-11-ndk-r21e

ubuntu-22.04-jdk-8-ndk-r21e（已弃用）

ubuntu-20.04-jdk-11-ndk-r23b（已弃用）

ubuntu-20.04-jdk-11-ndk-r21e（已弃用）

ubuntu-20.04-jdk-8-ndk-r21e（已弃用）

ubuntu-20.04-jdk-11-ndk-r19c（已弃用）

ubuntu-20.04-jdk-8-ndk-r19c（已弃用）

iOS 构建服务器配置

🌐 iOS build server configurations

iOS 构建器虚拟机在隔离环境中的 Mac mini 主机上运行。每次构建都会获得一个全新的 macOS 虚拟机。更多信息，请参见 iOS 特定资源类。

🌐 iOS builder VMs run on Mac mini hosts in an isolated environment. Every build gets its own fresh macOS VM. For more information, see iOS-specific resource classes.

• 构建资源：

  • medium: 5 performance cores, 20 GiB RAM, 110 GB SSD
  • large: 10 performance cores, 40 GiB RAM, 110 GB SSD

• npm 缓存

• CocoaPods 缓存

• 全局 npm 配置在 ~/.npmrc 中：

  ~/.npmrc

  Copy

  registry=http://npm.caches.eas-build.internal
  

• 全局 Yarn 配置在 ~/.yarnrc.yml 中：

  ~/.yarnrc.yml

  Copy

  unsafeHttpWhitelist:
    - '*'
  npmRegistryServer: 'http://npm.caches.eas-build.internal'
  enableImmutableInstalls: false
  

iOS 服务器镜像

🌐 iOS server images

macos-sequoia-15.6-xcode-26.2 (latest, sdk-55)

macos-sequoia-15.6-xcode-26.1

macos-sequoia-15.6-xcode-26.0 (sdk-54, macos-sequoia-15.5-xcode-26.0)

macos-sequoia-15.6-xcode-16.4 （如果你不想使用 Xcode 26，建议用于 SDK 54）

macos-sequoia-15.5-xcode-16.4 (sdk-53)

macos-sequoia-15.4-xcode-16.3

macos-sequoia-15.3-xcode-16.2 (sdk-52)

macos-sonoma-14.6-xcode-16.1

macos-sonoma-14.6-xcode-16.0

macos-sonoma-14.5-xcode-15.4 (sdk-51, sdk-50, sdk-49)

macos-sonoma-14.4-xcode-15.3

macos-ventura-13.6-xcode-15.2

macos-ventura-13.6-xcode-15.1

macos-ventura-13.6-xcode-15.0

支持的 Xcode 版本

🌐 Supported Xcode versions

我们旨在支持所有稳定的 Xcode 版本，这些版本允许你在构建过程中使用时将你的应用提交到 App Store Connect。

🌐 We aim to support all stable Xcode releases that allow you to submit your app to the App Store Connect when used during the build process.

这通常意味着我们支持最新的稳定版 Xcode 和前一个版本（直到 Apple 引入新的最低 Xcode 版本要求为止）。

🌐 This usually means that we support the latest stable Xcode version and the previous one (until the new minimal Xcode version requirement is introduced by Apple).