Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Excerpt

Titanium requires the Android SDK Tools to be installed in order to allow you to develop Android applications.

Note

Remember that Oracle JDK is a prerequisite for Android development and should be installed first. Note that macOS systems need to have the Java 6 runtime You need at least JDK 8 installed. See Installing Oracle JDK for instructions.

Section
Column
width66px

Column

The Android SDK Manager installer may be obtained from the Android Studio and SDK tools site.

Required Android Packages

The following packages, and the respective versions shown, must be installed to be able to develop for AndroidAs of Titanium 9.0.0, the build system will automatically download the Android SDK platforms and tools needed.

For Titanium 8.x.x, you need to installed the following packages via the Android SDK Manager yourself:

Titanium SDK 8.0.0+ requires Android SDK Tools v28 or newer as a minimum requirement.

Package

Minimum Version

Android SDK Tools

Rev 2528

Android SDK Platform-tools/ Build-tools

Rev 23

Android SDK

You need to have at least one Android SDK installed within the supported minimum and maximum target versions.

For Android modules, you need to install Android SDK 6.0.x (API 23) and SDK 6.0.0+.

Note
Platform (API Level)

API Level 29 for Titanium 8.3.x

API Level 28 for Titanium version older than 8.3.0

Note

 

Titanium SDK 7.0.0+ requires Android SDK Tools v25 or newer as a minimum requirement.

Note

Take caution before upgrading these packages, as changes to the way they work has broken the Titanium toolchain a number of times in the past. Although these problems are often beyond our control, we always do our utmost to fix them as soon as we are made aware of them.

With this in mind, it's important to only upgrade these packages between major projects, so that you have time to fix any problems that may result. Always consult the Android Tools Release Notes and Known Issues first, and refer to our Installation Troubleshooting guide to check whether there are any further actions that need to be taken to make the Titanium and the Android SDK compatible.

Android SDK / Target Android platform

Each Titanium SDK supports building against a specific range of Android versions, as shown in the following table, and requires at least one of these versions to be installed. If you specify a android:targetSDKVersion in the tiapp.xml file of your project, you must specify one within the target min and max values. The minimum Android/SDK version column indicates the minimum version of Android that a device can run, which a Titanium application supports.

Supported versions
8

Titanium SDK Version

Min Target Android/SDK Version
(android:targetSdkVersion)

Max Target Android/SDK Version
(android:targetSdkVersion) 

Minimum Android/SDK Version
(android:minSdkVersion) 
9.0.0 - latest6.0.x (API 23)10.0.x (API 29)4.4.x (API 19)
8.0.0 - 8.2.26.0.x (API 23)9.0.x (API 28)4.4.x (API 19)
7.5.0 - 7.5.16.0.x (API 23)9.0.x (API 28)

4.1.x (API 16)

7.3.0 - 7.4.16.0.x (API 23)8.1.x (API 27)4.1.x (API 16)
7.0.0 - 7.2.06.0.x (API 23)7.0.x (API 25)4.1.x (API 16)
Unsupported versions

Titanium SDK Version

Min Target Android/SDK Version
(android:targetSdkVersion)

Max Target Android/SDK Version
(android:targetSdkVersion) 

Minimum Android/SDK Version
(android:minSdkVersion) 
6.2.0 - 6.3.07.1.x (API 25)6.0.x (API 23)4.1.x (API 16)
6.0.0 - 6.1.x6.0.x (API 23)6.0.x (API 23)4.1.x (API 16)
5.1.0 - 5.5.x6.0.x (API 23)6.0.x (API 23)4.0.x (API 14)
5.0.0 - 5.0.x5.0.x (API 21)6.0.x (API 23)4.0.x (API 14)
4.0.0 - 4.1.x5.0.x (API 21)5.1.x (API 22)4.0.x (API 14)
3.4.1 - 3.5.14.0.x (API 14)*5.0.x (API 21)**2.3.x (API 10)
3.3.0 - 3.4.04.0.x (API 14)*4.4.x (API 19)2.3.x (API 10)
3.2.0 - 3.2.32.3.x (API 10)*4.4.x (API 19)2.3.x (API 10)
3.1.2 - 3.1.32.3.x (API 10)4.3.x (API 18)2.3.x (API 10)
3.1.12.3.x (API 10)4.2.x (API 17)2.3.x (API 10)
3.1.02.2 (API 8)4.2.x (API 17)2.2 (API 8)

2.1.2 - 3.0.2

2.2 (API 8)

4.1.x (API 16)

2.2 (API 8)

2.0 - 2.1.1

2.2 (API 8)

4.0.x (API 15)

2.2 (API 8)

1.8.x

2.2 (API 8)

3.x.x (API 11)

2.2 (API 8)

1.7.x

2.1 (API 7)

3.x.x (API 11)

2.1 (API 7)
Note
titleNotes

* If you are building an Android module, you need to have Android SDK 6.0.x (API 23) installed if using Release 6.0.0 and greater.

** The Titanium SDK does not support the Android 4.4W SDK (API 20), also known as the Android Wear SDK.

Most mobile device manufacturers have been licensed to use Google's enhanced API, which provides support for Maps and other functionality. If this is the case for your target devices, you will need to install the relevant Google packages, listed as Google APIs by Google Inc., Android API x... by the Android SDK Manager tool. In Studio, choose the SDKs with the naming format "Google APIs x.x" to use the enhanced APIs, or those without the "Google APIs" prefix otherwise.

Android SDK packages can be installed using the Android SDK Manager tool. See Installing the Android SDK for detailed instructions.

The default Android SDK can be configured using Studio's Preferences, and then selected per-project using the Run Configurations.

NoteFor
Android
API levels 14 and above, the emulator system images are installed separately from the SDK platform packages. To run in the emulator for Android API 14+, you must install at least one of the emulator system images.
Android Native Add-on Module Development on macOS

The Xcode command line tools are required to develop native Android add-on modules on macOS.

See Installing the iOS SDK: Installing Command Line Tools for detailed instructions.

...

Installing x86 Emulator Packages

Some versions of the Android API are available with Intel x86 emulators. Look for the "Intel x86 Atom System Image" in the Android SDK Manager.

The x86 emulator may run faster than the standard ARM emulator, but may show minor differences with the ARM emulator. Extra software is In the Android SDK Manager, under the SDK Platforms tab, you can find "Intel x86 Atom" and "Intel x86 Atom_64" system images. These are 32-bit and 64-bit emulator images of that platform's API Level and will run faster in the emulator compared to the ARM emulator images.

Extra software may be required to take advantage of the x86 emulator – see Configuring Virtual Machine Acceleration in the Android Tools documentation.

...

Configuring Appcelerator Studio

To use the Android SDK with Appcelerator Studio, the path to the SDK must be set in the Preferences dialog.

...