Toolchain Images

A toolchain image is the runner setup for a build: the OS plus Xcode or the Android SDK. Pin one when your build needs a specific version. The configuration snippet below focuses on image selection. Keep the recipe’s runnable app_id and output_path alongside its build_commands.

Selecting an image

If you don’t pick one, the platform’s current default is used. Pin an image in config or per invocation:

build:
  framework: ios
  profiles:
    release:
      ios:
        build_commands: ["./scripts/build-release"]
        image: ios-macos-26-xcode-26.2

revyl build --profile release --platform ios --remote \
  --image ios-macos-26-xcode-26.2

Image precedence is --image, then the selected recipe’s image, then the platform default. The special value latest uses the platform default. Image selection affects remote execution only; the same recipe’s commands and output remain unchanged when it runs locally. PR preview builds accept the same keys via the image field in the GitHub integration config.

iOS images

ios-macos-26-xcode-26.5 (default)

Tool	Version
Xcode	26.5
Node.js	22.23.0
npm	10.9.8
Yarn	1.22.22
pnpm	11.9.0
Bun	1.3.14
node-gyp	13.0.0
CocoaPods	1.17.0
git	2.55.0
git-lfs	3.7.1
ccache	4.13.6
watchman	2026.07.27.00
bash	5.3.15

ios-macos-26-xcode-26.2

Tool	Version
Xcode	26.2
Node.js	20.19.4
npm	10.9.3
Yarn	1.22.22
pnpm	10.28.2
Bun	1.3.8
node-gyp	12.2.0
CocoaPods	1.17.0
git	2.55.0
git-lfs	3.7.1
ccache	4.13.6
watchman	2026.07.27.00
bash	5.3.15

Android images

android-ubuntu-24.04-jdk-17-ndk-r27b (default)

Tool	Version
Ubuntu	24.04 (arm64, with Rosetta translation for x86_64 binaries)
OpenJDK	17 (`JAVA_HOME` preset)
Gradle	9.4.1 (project `gradlew` wrappers also work)
Gradle JVM defaults	6 GB heap, 2 GB metaspace, exit immediately on JVM OOM
Android platforms	android-33, android-34, android-35, android-36
Android build-tools	33.0.2, 34.0.0, 35.0.0, 36.0.0
Android cmdline-tools	14742923
Android platform-tools	latest at image build
NDK	27.1.12297006 (r27b)
CMake	3.22.1
ninja	Ubuntu 24.04 package
Node.js	22.22.2
npm	10.9.4
Yarn	1.22.22
pnpm	10.33.3
Bun	1.3.13
node-gyp	12.3.0
Maestro	2.5.1
git / git-lfs	Ubuntu 24.04 packages
ccache	Ubuntu 24.04 package
Python	3.x (Ubuntu 24.04 package)

Need a different toolchain?

If your build needs an Xcode, JDK, NDK, or SDK version that isn’t listed, contact [email protected]. New toolchain images are published as additional keys.

Configuration: where the image field lives
Caching: automatic compilation and configured path caches

Getting Started

CLI

Builds

Tests

Develop

Atlas

Integrations

Appendix

Selecting an image

iOS images

Android images

Need a different toolchain?

​Selecting an image

​iOS images

​Android images

​Need a different toolchain?

​Related

Selecting an image

iOS images

Android images

Need a different toolchain?

Related