构建服务器基础设施

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

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

构建服务器 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-55。

• 使用特定名称可保证环境一致，仅会有小幅更新。
• 使用 auto 别名时，构建镜像将根据项目配置、Expo SDK 版本和 React Native 版本来选择。你可以在构建日志的 Spin up build environment 部分查看此次构建使用了哪个镜像。
• 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 构建器运行在隔离环境中的虚拟机上。每次构建都会获得自己的专用 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)

• 使用 Kubernetes 部署的 npm 缓存

• 使用 Kubernetes 部署的 Maven 缓存

• ~/.gradle/gradle.properties 中的全局 Gradle 配置：

  ~/.gradle/gradle.properties

  Copy

  org.gradle.jvmargs=-Xmx14g -XX:MaxPermSize=512m -XX:+HeapDumpOnOutOfMemoryError -Dfile.encoding=UTF-8
  org.gradle.parallel=true
  org.gradle.configureondemand=true
  org.gradle.daemon=false
  

• ~/.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
  

Android 服务器镜像

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）

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-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 版本

我们的目标是支持所有稳定版 Xcode 发布版本，只要在构建过程中使用它们时，你就能将应用提交到 App Store Connect。

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