Android Build Stacks
For each Android build, Appcircle creates a brand new virtual machine;
- If you select "Appcircle Linux Pool (x86_64)", virtual machine will be Debian 11 Bullseye.
- If you select "Appcircle Standard macOS Pool (arm64)", virtual machine will be macOS Sonoma
14.5or macOS Monterey12.6.
If you select Appcircle Standard macOS Pool (arm64), you can not choose macOS version. It will be automatically selected by Appcircle.
The chance is equal for both macOS Sonoma and macOS Monterey for your android build because it does not effect your build.
Virtual machines are created and they become ready for build within seconds.
During the build process, you can install any dependencies and run commands using custom script steps in the build workflow. This gives you complete control over your build and the virtual machine.
Please note that virtual machines are wiped off after a build is executed (no matter success or fail) and anything you installed in the virtual machine will be gone.
Java Version
Build agents have Java 8, 11, 17 and 21 installed. Java 17 is set as the default version.
If you want to use a different Java version, please add the Select Java Version component to your workflow.
When you select "Appcircle Linux Pool (x86_64)" for Android builds, the following JDK locations are available within the environment variables:
- JAVA_HOME_8_X64:
/root/.sdkman/candidates/java/8.0.392-zulu - JAVA_HOME_11_X64:
/root/.sdkman/candidates/java/11.0.21-zulu - JAVA_HOME_17_X64:
/root/.sdkman/candidates/java/17.0.9-zulu - JAVA_HOME_21_X64:
/root/.sdkman/candidates/java/21.0.2-zulu
We're deprecating Intel-based runners and transitioning our customers to Apple silicon-based (M-series) build machines.
Although Intel-based runners are actively maintained, if your app does not specifically require an Intel-based build machine, we suggest using the "Appcircle Standard macOS Pool (arm64)", since it has much more build capacity and the latest updates as well.
When you select "Appcircle Standard macOS Pool (arm64)" for Android builds, the following JDK locations are available within the environment variables:
- JAVA_HOME_8_X64:
/Users/appcircle/.sdkman/candidates/java/8.0.392-zulu - JAVA_HOME_11_X64:
/Users/appcircle/.sdkman/candidates/java/11.0.21-zulu - JAVA_HOME_17_X64:
/Users/appcircle/.sdkman/candidates/java/17.0.9-zulu - JAVA_HOME_21_X64:
/Users/appcircle/.sdkman/candidates/java/21.0.2-zulu
Emulator
Build agents have Pixel_3a Android 9.0 emulator pre-installed. You may add or remove other emulators by using sdkmanager.
For example, in order to install Android 11 (API 30) emulator to x86_64 Linux, you can take the below steps:
1. Install emulator system image if not exists. (If it exists, the command will return quickly with success.)
sdkmanager "system-images;android-30;google_apis;x86_64"
You can see a list of available system images with the below command:
sdkmanager --list | grep "system-images;android"
2. Create new pixel_3a device with "Pixel_Custom" emulator name.
avdmanager create avd -n Pixel_Custom -k "system-images;android-30;google_apis;x86_64" -c 512M -d pixel_3a
When completed with success, you should see below the device with avdmanager list avd:
Name: Pixel_Custom
Device: pixel_3a (Google)
Path: /users/appcircle/.android/avd/Pixel_Custom.avd
Target: Google APIs (Google Inc.)
Based on: Android 11.0 (R)
Tag/ABI: google_apis/x86_64
Sdcard: 512 MB
If you're using UI tests with emulators, you must select an Intel device (Appcircle Linux Pool (x86_64)) since M-series virtual machines (Appcircle Standard macOS Pool (arm64)) don't support nested virtualization.
Android Build Agent Stacks
There are many pre-installed packages in virtual machines. You can get a full list of pre-installed packages by running Bash commands in custom script steps.
Here are some most important packages installed in our Linux and macOS images used for Android builds:
| Package | Debian Bullseye | macOS Sonoma | macOS Monterey |
|---|---|---|---|
| Apt Package Manager | 2.2.4 | n/A | n/A |
| Bash | 5.1.4 | 3.2.57 | 3.2.57 |
| GNU Binutils | 2.35.2 | 2.42 | 2.39 |
| Bzip2 | 1.0.8 | n/A | n/A |
| Curl | 7.74.0 | 8.6.0 | 7.79.1 |
| GCC | 10.2.1 | 16.0.0 | 14.0.0 |
| Git | 2.35.1 | 2.45.2 | 2.38.1 |
| Git LFS | 2.13.2 | 3.5.1 | 3.2.0 |
| Gradle | 4.4.1 | 8.8 | 7.5.1 |
| Gzip | 1.10 | 430.100.5 | 353.100.22 |
| Java | 17.0.9 | 17.0.9 | 17.0.9 |
| Maven | 3.9.9 | 3.9.7 | 3.8.6 |
| Node JS | 18.20.5 | 18.20.3 | 18.19.1 |
| OpenSSL | 1.1.1 | 3.3.6 | 2.8.3 |
| Perl | 5.32.1 | 5.34.1 | 5.30.3 |
| Python | 3.9.2 | 3.12.3 | 3.10.8 |
| Rake | 13.2.1 | 13.0.6 | 13.0.1 |
| Rbenv | 1.3.0 | 1.2.0 | 1.2.0 |
| Ruby | 3.2.3 | 3.2.3 | 2.7.5 |
| Unzip | 6.00 | 6.00 | 6.00 |
| Wget | 1.21 | 1.24.5 | 1.21 |
| Yarn | 1.22.22 | 1.22.22 | 1.22.19 |
| Zip | 3.0 | 3.0 | 3.0 |
Using your own computer for build
Appcircle supports using a third-party computer to perform builds. You can create your own build environment by installing the operating system and other tools and dependencies you need to tell Appcircle to use that environment to perform builds.
Appcircle Self-hosted Runner