Setup Android

Automatic Install

There is no automatic setup available for Android.

Manual Install

Similar to standard Android native development, you will need the following installed:

After installing the Android SDK, you should install the Android SDK platform-tools and Android API 26 packages from the Android SDK Manager. Gradle requires specific versions of the Android SDK Build Tools, and Lime will try to find the latest version installed. You can override this by setting <config:android build-tools-version="" /> in your project file.

Lime uses API 26 to support modern Android features, but is still compatible with API 16 devices. You only need to install the newer API package.

Using the latest HXCPP, and targeting modern Android platforms properly, requires NDK version r15c. Newer versions are not compatible with the release version of HXCPP, but an update is coming soon that will support later releases.

The Android build tools did not properly support new versions of Java for a long time, but now Java 8 is recommended to work properly with the current Android Gradle build system. Make sure that you have a JDK version installed.

After these tools are installed, Lime still needs to know where they are installed. Open a command-prompt or terminal and run the following command:

lime setup android

When prompted to automatically download and install each component, type ā€œnā€ and press enter. At the end, the setup process will ask for each location. When prompted, enter the path to where the Android SDK, NDK and other components are installed.

If you intend to use an Android emulator, create an AVD with hardware acceleration that targets Android 4.1 or greater. You may also need to install drivers for your Android device, before you can deploy to it. Note that x86 emulators and devices are supported.


If you encounter any problems when setting up Lime for Android, please visit the forums.

Improve this page