This documentation is available as Markdown for AI agents and LLMs. See the full Markdown index or append .md to any documentation URL.

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

构建服务器 IP 地址

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

Linux 运行器托管在 Google Cloud Platform 上。macOS 运行器托管在我们自己的 macOS 云中。

配置构建环境

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

在选择构建镜像时，你可以使用下面提供的完整名称，或使用以下别名之一：auto、latest，或者针对特定 SDK 的别名，例如 sdk-57。

• 使用特定名称可保证环境一致，仅会有少量更新。
• 使用 auto 别名时，构建镜像将根据项目配置、Expo SDK 版本以及 React Native 版本来选择。你可以在构建日志的 启动构建环境 部分查看本次构建使用了哪个镜像。
• latest 别名将指向软件版本最新的镜像。
• sdk-57 别名将指向最适合 SDK 57 构建的镜像。
• sdk-56 别名将指向最适合 SDK 56 构建的镜像。
• 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 构建器运行在隔离环境中的虚拟机上。每次构建都会获得自己的专用 VM 实例。

• 构建资源：

  • 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)

• npm 缓存已通过 Kubernetes 部署

• Maven 缓存已通过 Kubernetes 部署

• 构建环境预配时，会通过 GRADLE_OPTS 环境变量注入 Gradle JVM 参数。请参见下方的 Gradle JVM 参数。

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

  ~/.npmrc

  Copy

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

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

  ~/.yarnrc.yml

  Copy

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

Gradle JVM 参数

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

除了 -Xmx 之外，worker 还会通过 -Dorg.gradle.jvmargs 向 Gradle 构建 JVM 传递以下 JVM 参数：

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

worker 还会通过 GRADLE_OPTS 设置这些顶层 Gradle 属性：

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

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

覆盖 GRADLE_OPTS

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

Android 服务器镜像

ubuntu-26.04-jdk-17-ndk-r27b-sdk-57 (latest, sdk-57)

ubuntu-26.04-jdk-17-ndk-r27b (sdk-56)

ubuntu-24.04-jdk-17-ndk-r27b-sdk-55 (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）

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 构建器 VM 运行在 Mac mini 主机上的隔离环境中。每次构建都会获得一个全新的 macOS VM。更多信息请参见iOS 特定资源类。

• 构建资源：

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

• npm 缓存

• CocoaPods 缓存

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

  ~/.npmrc

  Copy

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

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

  ~/.yarnrc.yml

  Copy

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

iOS 服务器镜像

macos-tahoe-26.5-xcode-26.6 (latest, sdk-57)

macos-tahoe-26.4-xcode-26.4 (sdk-56)

macos-sequoia-15.6-xcode-26.2 (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 版本

我们的目标是尽快支持所有稳定版 Xcode 发布版本，只要它们可用于构建流程，你就可以将应用提交到 App Store Connect。

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