MY ACCOUNT / MY ORGANIZATON
BEST PRACTICES

Appcircle-Specific (Reserved) Environment Variables

Here is a list of pre-defined environment variables in Appcircle.

These reserved environment variables are either predetermined by Appcircle or they are set in the build configuration.

You can how these environment variables are utilized within the related workflow step. For instance, you can set the Xcode version of a build profile through the build configuration, which will then set this value as the AC_XCODE_VERSION environment variable.

You can then use this variable in any workflow step and this variable will be assigned as the default input value of the Xcode Select workflow step. This assignment is editable, meaning that you can either choose to keep it in the same way it is configured or you can change it by specifying a value directly in the step settings or assigning a different environment variable.

For more information on the inputs of the steps and how the variables in the following steps are used, please refer to the documentation of the specific step that is available at https://github.com/appcircleio

iOS & Android common environment variables

Variable

Description

AC_OUTPUT_DIR

Output folder path to upload artifacts

AC_TEMP_DIR

Path to temp directory

AC_ENV_FILE_PATH

Path to the environment file

AC_REPOSITORY_DIR

Clone repository destination

AC_PROJECT_PATH

Project path (For Android, gradlew file path. For iOS, .xcodeproj or .xcworkspace file path)

AC_APPCIRCLE

Set to true when Appcircle starts a build

AC_METADATA_OUTPUT_PATH

Metadata output file path

Android specific environment variables

Variable

Description

ANDROID_HOME

Android SDK installation directory

AC_MODULE

Selected Android module

AC_VARIANT

Selected Android variant

AC_OUTPUT_TYPE

Selected output type of Android artifact

AC_APK_PATH

Generated APK file path

AC_AAB_PATH

Generated AAB file path

AC_SIGNED_APK_PATH

Generated signed APK file path

AC_SIGNED_AAB_PATH

Generated signed AAB file path

AC_ANDROID_KEYSTORE_PATH

Selected Android keystore path

AC_ANDROID_KEYSTORE_PASSWORD

Password for the selected keystore

AC_ANDROID_ALIAS

Selected alias name

AC_ANDROID_ALIAS_PASSWORD

Selected alias password

AC_ANDROID_APP_ANALYSIS_PATH

Location of the app analyzer JSON file

AC_GIT_URL

Git URL of the repository

AC_GIT_COMMIT

The Git commit that is built

AC_GIT_BRANCH

The Git branch that is built (eg: master)

iOS specific environment variables

Variable

Description

AC_XCODE_LIST_DIR

Specifies the Xcode folder list path

AC_SCHEME

Specifies the project scheme for build

AC_ARCHIVE_FLAGS

Specifies the extra Xcodebuild flag. For example : -configuration DEBUG

AC_XCODE_VERSION

Specifies the Xcode version

AC_ARCHIVE_PATH

Archive path

AC_ARCHIVE_METADATA_PATH

Archive metadata path

AC_SIMULATOR_ARCHIVE_PATH

Simulator archive path description

AC_METADATA_OUTPUT_PATH

Metadata output file description

AC_CERTIFICATES

URLs of the certificates

AC_PROVISIONING_PROFILES

URLs of the provisioning profiles

AC_EXPORT_DIR

Specifies the path that contains ipa, exportOptions.plistand other exported files

AC_BUNDLE_IDENTIFIERS

Specifies the project bundle identifiers

Smartface specific environment variables

Variable

Description

AC_SMARTFACE_PLAYER_VERSION

Smartface player version

AC_SMARTFACE_CLI_VERSION

Smartface CLI version