To install and run AIR your development environment must meet these minimum requirements:
- 1.3GB free disk space (for the AIR SDK and does not include other tools)
- A version of Java 11
Install the SDK
You have two options to install the AIR SDK. The recommended method is to use the AIR SDK Manager. The manager will inform you of available updates and minimise the download required for each update.
Alternatively you can manually download the AIR SDK.
- AIR SDK Manager
- Download the latest release bundle of the AIR SDK Manager:
Start the installer and follow the prompts to install the application.
Once installed, set the AIR SDKs Location on your machine.
This location will be where the AIR SDK Manager installs versions of the AIR SDK. This can be an existing directory of AIR SDKs however it is recommended to select a new location, eg
The manager will construct a directory for each major version of the AIR SDK (eg
AIRSDK_50.2.1), with point releases just be considered as updates.
- Select one of the available SDK versions and click the gear icon to Install the SDK. Once installed you can click Locate to locate the installation.
- Download the latest release bundle of the AIR SDK:
For older versions see the SDK releases page.
- Extract the bundle in the desired location, for example:
- Remove any quarantine that macOS may have applied to the zip by running the following command on the directory you extracted the SDK to:
sudo xattr -r -d com.apple.quarantine ~/sdks/air
Set your Environment
Next you will want to add the AIR SDK tools to your path so you can execute the build commands.
- Permanently adding the path will depend on the shell you are using on your machine. Typing
echo $SHELLin your Terminal will generally tell you which sheel you are using and then you can edit the
rcfile for that shell type, the most common types are:
/bin/bash: Edit the
/bin/zsh: Edit the
- Once you have determined the shell type add the following changing the
[AIR_SDK_PATH]to be the path you installed the AIR SDK to above:
source ~/.<rc file>or start a new Terminal window to refresh the environment.
Verify the AIR SDK
bindirectory is in your path by running:
Verify you can access the AIR SDK commands by running:
which adt adl
You can check the version of the AIR SDK by running
While not entirely necessary, downloading Xcode will give you access to the latest developer tools and is highly recommended. This will also give you access to the iOS simulator so you can run your iOS applications in the iOS simulator on your development machine.
Install the latest version of Xcode (using the download or via the Mac App Store).
Ensure you have selected the latest version for the command line tools using:
sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer
sudo xcodebuild -runFirstLaunch
- Make sure you have accepted the license agreement by opening Xcode once and confirming (or running
sudo xcodebuild -licensefrom a Terminal).
Setup the iOS Simulator
Make sure you can launch the iOS simulator by running the following in a Terminal:
open -a Simulator
AIR relies on the Android SDK and build tools in order to produce AAB builds and support the latest Android functionality.
You can either install the Android SDK directly or we suggest you install Android Studio (which includes the SDK) as this makes the installation process easier and provides additional debugging tools.
Install Android Studio
- Download Android Studio
- Start Android studio and run through the setup wizard which will install the latest Android SDK, command line tools and build tools.
Set up your Android device
If you have an Android device you intend on debugging with you must make sure you have set up the device for debugging.
- In order to debug an application on an Android device you need to enable "Developer Mode" and then enable USB debugging. Detailed process is described in the Android documentation.
- Plug your device into your machine using a cable, and you should receive a prompt on the device to authorise access via the computer;
- Run the following command and you should see a device listed:
adt -devices -platform android
You must make sure you have version 11 of the Java Development Kit installed and that your
JAVA_HOME environment variable is set to the JDKs folder.