We provide a setup that automatically downloads and installs all Android SDK requirements. Note that you'll also be able to access this setup through the Update Android SDK tool menu option from Genexus IDE.
We discourage installing the Android SDK components manually, but it some cases it may be necessary. So we provide you with the information you'll need to do it.
- Oracle JDK — Version 8 (Use the 64-bit version if you are on a 64-bit operating system).
- Android SDK — Only the command line tools are needed.
Note: It is strongly recommended to install the Android SDK (in any directory) with no blank spaces or any special characters
Note: The tool known as "Android SDK Manager" program has been deprecated by Google and is no longer available
You'll have two options using the command line tool "sdkmanager" provided by the Android SDK or downloading Android Studio and using the "SDK Manager" built-in. In either case, you'll have to install the following components. Each component per upgrade can be found in <genexus_directory>/Android/RequirementsTool/android_requirements.txt.
Note: Google Play requires that new apps target at least Android 11 (API level 30) from August 2021, and that app updates target Android 11 from November 2021. This implies that you must use
GeneXus 17 upgrade 2 or higher to be able to deploy to Google Play. More information in
Play Console Help site.
| GeneXus 15 Upgrade 9 or higher users. |
| Component |
Required Version |
Comments |
| Android SDK Tools |
26.0.2 or higher |
Refer to Update Android SDK tool option. |
| Android SDK Platform-Tools |
23.1 or higher |
- |
| Android SDK Build-tools |
26.0.2 exactly |
- |
| Android Emulator |
27.0.5 |
- |
| Android 8.0 (API 26) |
Any |
- |
| - SDK Platform |
|
- |
| - Google APIs Intel x86 Atom System Image |
Any |
If you have an Intel-based computer, use the Intel x86 System Image. Otherwise, use the ARM EABI v7a System Image.
If there are any AVD already created with the previous requirement (Intel x86 Atom System Image), it will not be re-created. You may consider to delete it from the AVD Manager and re-run the app from GeneXus to create a new one. |
| Android Support Repository |
45 or higher |
- |
| Google Repository |
44 or higher |
- |
| Intel x86 Emulator Accelerator (HAXM installer) |
Any |
If HAXM cannot be installed, it is necessary to install Android 4.1.2 (API 16), including SDK Platform and ARM EABI v7a System Image. Check "Android API levels considerations" section. |
| GeneXus 15 Upgrade 7 and GeneXus 15 Upgrade 8. |
| Component |
Required Version |
Comments |
| Android SDK Tools |
25.3.1 or higher |
Refer to Update Android SDK tool option. |
| Android SDK Platform-Tools |
23.1 or higher |
- |
| Android SDK Build-tools |
26.0.2 exactly |
- |
| Android Emulator |
Any |
- |
| Android 7.0 (API 24) |
Any |
- |
| - SDK Platform |
|
- |
| - Google APIs Intel x86 Atom System Image |
Any |
If you have an Intel-based computer, use the Intel x86 System Image. Otherwise, use the ARM EABI v7a System Image.
If there are any AVD already created with the previous requirement (Intel x86 Atom System Image), it will not be re-created. You may consider to delete it from the AVD Manager and re-run the app from GeneXus to create a new one. |
| Android Support Repository |
45 or higher |
- |
| Google Repository |
44 or higher |
- |
| Intel x86 Emulator Accelerator (HAXM installer) |
Any |
If HAXM cannot be installed, it is necessary to install Android 4.1.2 (API 16), including SDK Platform and ARM EABI v7a System Image. Check "Android API levels considerations" section. |
| GeneXus 15 Upgrade 5 and GeneXus 15 Upgrade 6 users. |
| Component |
Required Version |
Comments |
| Android SDK Tools |
25.3.1 or higher |
Refer to Update Android SDK tool option. |
| Android SDK Platform-Tools |
23.1 or higher |
- |
| Android SDK Build-tools |
23.0.2 exactly |
- |
| Android Emulator |
Any |
- |
| Android 7.0 (API 24) |
Any |
- |
| - SDK Platform |
|
- |
| - Google APIs Intel x86 Atom System Image |
Any |
If you have an Intel-based computer, use the Intel x86 System Image. Otherwise, use the ARM EABI v7a System Image.
If there are any AVD already created with the previous requirement (Intel x86 Atom System Image), it will not be re-created. You may consider to delete it from the AVD Manager and re-run the app from GeneXus to create a new one. |
| Android Support Repository |
45 or higher |
- |
| Google Repository |
44 or higher |
- |
| Intel x86 Emulator Accelerator (HAXM installer) |
Any |
If HAXM cannot be installed, it is necessary to install Android 4.1.2 (API 16), including SDK Platform and ARM EABI v7a System Image. Check "Android API levels considerations" section. |
| GeneXus 15 Upgrade 3 and GeneXus 15 Upgrade 4 users. |
| Component |
Required Version |
Comments |
| Android SDK Tools |
25.1.7 or higher |
- |
| Android SDK Platform-Tools |
23.1 or higher |
- |
| Android SDK Build-tools |
23.0.2 exactly |
- |
| Android 7.0 (API 24) |
Any |
- |
| - SDK Platform |
|
- |
| - Google APIs Intel x86 Atom System Image |
|
If you have an Intel-based computer, use the Intel x86 System Image. Otherwise, use the ARM EABI v7a System Image.
If there are any AVD already created with the previous requirement (Intel x86 Atom System Image), it will not be re-created. You may consider to delete it from the AVD Manager and re-run the app from GeneXus to create a new one. |
| Android Support Repository |
45 or higher |
- |
| Google Repository |
44 or higher |
- |
| Intel x86 Emulator Accelerator (HAXM installer) |
Any |
If HAXM cannot be installed, it is necessary to install Android 4.1.2 (API 16), including SDK Platform and ARM EABI v7a System Image. Check "Android API levels considerations" section. |
| GeneXus 15, GeneXus 15 Upgrade 1 and GeneXus 15 Upgrade 2 users. |
| Component |
Required Version |
Comments |
| Android SDK Tools |
25.1.7 or higher |
- |
| Android SDK Platform-Tools |
23.1 or higher |
- |
| Android SDK Build-tools |
23.0.2 exactly |
- |
| Android 7.0 (API 24) |
Any |
- |
| - SDK Platform |
|
- |
| - Intel x86 Atom System Image |
|
If you have an Intel-based computer, use the Intel x86 System Image. Otherwise, use the ARM EABI v7a System Image. |
| Android Support Repository |
36 or higher |
- |
| Google Repository |
36 or higher |
- |
| Intel x86 Emulator Accelerator (HAXM installer) |
Any |
If HAXM cannot be installed, it is necessary to install Android 4.1.2 (API 16), including SDK Platform and ARM EABI v7a System Image. Check "Android API levels considerations" section. |
This step is only necessary if your computer has an Intel-based CPU.
Once you have finished downloading the requirements, you must install HAXM. Then, open the <Android_SDK_Installation_Directory>/Extras/Intel/Hardware_Acelerated_Execution_Manager directory, execute the intelhaxm-android.exe installer and follow its instructions.
With this configuration, you can run Android applications on your device (if it is plugged into your computer).
Recomendation: HAXM only works in Intel processors if the Hyper-V feature of Windows platform is turned off and VT-x is enabled in your BIOS.
- In order to check if Hyper-V is disabled, open Control Panel > Programs > Turn Windows features on or off and then, in the pop-up windows, make sure that Hyper-V is not checked.
- Detailed information about how to enable VT-x from the BIOS can be found on this post
- The generated Android application works in devices with API 16 (Android 4.1.2, Jelly Bean) or higher
- There is no "maximum" OS version supported for a given GeneXus upgrade. Generated applications will still function in OS versions released after the release of the GeneXus upgrade. However, new features of these newer OS versions will require a new GeneXus upgrade release to be fully supported.
If you have doubts about what Android SDK version you have installed and/or what API levels it supports you may:
- Run the following command to get a list of all installed APIs:
C:\<Android_SDK_Installation_Directory>\Tools\android.bat list target
- Run the SDK Manager from the Windows Start menu or the following command:
C:\<Android_SDK_Installation_Directory>\"SDK manager"
Warning: These components are not longer available as of Android SDK 25.3.0.
- The GeneXus setup program searches for the Android SDK version in the Windows registry key "HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Android SDK Tools" for 64 bits Windows and in "HKEY_LOCAL_MACHINE\SOFTWARE\Android SDK Tools" for 32 bits Windows.
- Once the SDK Directory is found it searches the file "<Android_SDK_Installation_Directory>\tools\source.properties" to check that the property "Pkg.Revision=" is 23.0.2
- If you are using an Intel processor and the HAXM installer produces the following error:
You must check that VT-x (Virtualization) is enabled in your BIOS and that you haven't installed HyperV.
- If you are using Parallels to run Genexus in a Windows VM, do NOT place the Android SDK you use on your host machine or in your model directory. The Android Gradle Plugin does not support this, and it may lead to strange behavior while compiling (for example, your computer could stop working).
As stated above, Android SDK requires at least 3GB of free space on your disk.
2 GB of RAM are required by default for compilation approx; this value can be changed in the Android specific properties.