Would you like to contribute to the Titanium docs? To get started, sign up for an account on the Appcelerator Wiki and sign our CLA.

Skip to end of metadata
Go to start of metadata
Contents

Overview

This document describes the system environments that are compatible with Titanium. Any components that fall outside of the min/max version ranges shown are considered not to be compatible.

Supported SDK Releases

Some information about legacy Titanium SDK versions is included here solely for reference. Thus, only the following releases are officially supported:

  • 3.5.x
  • 3.4.x
  • 3.3.x
  • 3.2.x

Pre-release Versions

Be aware that any components notated as Pre-release are not officially supported. This includes Beta, Developer Preview, and Release Candidate versions, as well as any development SDKs released via the Continuous Builds download site.

Minimum System Requirements

Memory

Product

Host Operating System

RAM

Titanium Studio

All

1GB (contiguous)

Latest Android SDK

OS X

1.5GB (contiguous)

Latest Android SDK

Windows

1GB (contiguous)

Latest Android SDK

Ubuntu

1.5GB (contiguous)

Blackberry SDK

All

2 GB

As a general rule, 4 GB RAM is usually adequate to run the whole Titanium environment.

 

Operating System

Titanium is supported on the following Operating Systems:

Operating System

Version

OS X

10.9.4 and later (Mavericks)

Windows

Windows 7 
Windows 8

Linux Desktop

Ubuntu 12.04 LTS (Precise Pangolin)

 

Java Development Kit

Oracle's Java Development Kit (JDK) is required to be installed in order to work with Titanium.

Icon

Be aware that no other flavors of JDK, such as OpenJDK, currently work with Titanium; only Oracle's will suffice.

Titanium supports the following versions of JDK for each respective Operating System:

Operating System

Min JDK Version

Max JDK Version

Package Arch Version

Download Location

Notes

OS X

6 (aka 1.6) rev 10

8 latest revision

64-bit

Apple Developers

  • On Mac OS X 10.6 (Snow Leopard) and earlier, the JDK is preinstalled.
  • On Mac OS X 10.7 (Lion) and later, the OS should prompt you to install it when needed. 

Windows

6 (aka 1.6) rev 10

8 latest revision

32-bit only (x86 / i586)

Official Website

  • The 32-bit version of the JDK is required regardless of whether Titanium is running on a 32-bit or 64-bit Windows system.
  • Titanium Studio offers to install JDK 7 if no JDK is found.

Linux Desktop

6 (aka 1.6) rev 10

8 latest revision

32-bit and 64-bit

Official Website

  • This package must be installed to launch Studio on Linux systems.
  • If using the 64-bit JDK, the ia32-libs package is required.

See Installing Oracle JDK for detailed instructions.

Node.js

To run all Appcelerator components, you must have Node.js 0.10.13 or later.

On Mac OS X and Windows, if you have selected to install Titanium updates, Studio prompts you to install Node.js. On Linux, you need to manually install Node.js.

Operating System

Package Name

Package Version

Download Location

OS X

node

Latest

Official Website

Windows

node

Latest

Official Website

Linux Desktop

nodejs

Latest

Official Website  or Default Repositories

See Installing Node for details.

Titanium Studio

Titanium Studio is a Java application, which requires Oracle's Java Runtime Environment (JRE) installed.  As JRE is a component of Oracle's Java Development Kit (JDK) and JDK is a prerequisite for development with other SDKs, JDK needs to be installed on all systems working with Titanium.  Refer to the Java Development Kit section of this document.

When running on Linux, Titanium Studio also requires the GTK windowing system.

Use the latest stable version of Titanium Studio, which can be downloaded from your Appcelerator My Resources portal, once you have registered an Appcelerator account.

See Quick Start for setup guide for further instructions.

Mobile Development

Titanium can provide a development environment for third-party mobile platforms where a Software Development Kit (SDK) has been made available by the platform vendor. With this in mind, development with the following combinations of Operating Systems and SDKs are possible:

PlatformOS XLinux DesktopWindowsNotes
Android Development
(tick)
(tick)
(tick)
 
BlackBerry Development
(tick)
(tick)
(tick)
 
iOS Development
(tick)
(error)
(error)
Due to Apple's license agreement, iOS applications may only be developed on Apple hardware.
Mobile Web Development
(tick)
(tick)
(tick)
 
Windows Development
(error)
(error)
(tick)

Windows applications may only be developed on hardware running Microsoft Windows.

Currently, Windows development is only supported using the Titanium CLI 3.3.0 and later, Titanium SDK 3.3.0 and later, and Visual Studio 2012/2013 Pro edition or higher.

 

 

Android

See Installing the Android SDK for detailed instructions.

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

Icon

Remember that Oracle JDK is a prerequisite for Android development and should be installed first. See Installing Oracle JDK for instructions.

The Android SDK Manager installer may be obtained from the Official Website.

Required Android Packages

The following packages, and the respective versions shown, must be installed to be able to develop for Android:

Package

Version

Android SDK Tools

Rev 23

Android SDK Platform-tools/Build-tools

Rev 21 (Rev 19.0.3 and later requires Titanium SDK 3.2.2 or later.)

Android SDK
  • For Release 3.2.0 and later, you need to have at least one Android SDK installed within the supported minimum and maximum target versions.
  • For Release 3.1.x and prior, you need to have the minimum supported Android SDK installed.
  • For Android modules, you need to install Android SDK 5.0.x (API 21) if using Release 4.0.0 and later, or Android SDK 2.3.x (API level 10) if using a Release prior to 4.0.0.

See section below for the range of supported SDKs.

Icon

If you are using Titanium SDK 3.1.0 and earlier, Android SDK Tools r22 may break your Android builds as described in TIMOB-13944. To workaround this issue, either:

  • Create symlinks between the old and new locations of the test tools:

Icon

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.

For Release 3.1.x and prior, the minimum target Android API level must be installed to use the Titanium SDK. The Titanium SDK will not work with Android SDKs earlier than the minimum Android SDK version. The maximum SDK version in the table below represents the maximum Android SDK version that the Titanium SDK was tested against.

Titanium SDK Version

Min Target Android/SDK Version
(android:targetSdkVersion)

Max Target Android/SDK Version
(android:targetSdkVersion) 

Minimum Android/SDK Version
(android:minSdkVersion) 
4.0.05.0.x (API 21)5.0.x (API 21)TBD
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)

Notes

Icon

(*) If you are building an Android module, you need to have Android SDK 5.0.x (API 21) installed if using Release 4.0.0 and greater. Prior to Release 4.0.0, you need to have Android SDK 2.3.x (API 10) installed.

(**) The Titanium SDK does not support the Android 4.4W SDK (API 20), also know 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.

Icon

For 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.

Icon

Due to this Android bug, webViews created on a virtual device running Android 2.3.x cause applications to behave erratically and crash. Thus, if developing on an emulator, it is recommended to use one of the other supported versions (Android 2.2, for instance). In contrast, applications that include webViews run as expected on (physical) devices installed with Android 2.3.2+. Note that Google has pronounced 2.3.1 obsolete and, as such, it is not supported.

Android Native Add-on Module Development on Mac OS X

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

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

Blackberry

See Installing the BlackBerry NDK for detailed instructions.

Titanium requires the BlackBerry 10 NDK to develop BlackBerry applications as well as the BlackBerry Device Simulator to test applications.

BlackBerry Native SDK and QNX Momentics IDE

To install the BlackBerry NDK, you need to first download and install the QNX Momentics IDE. When you launch the QNX Momentics IDE for the first time, you will be prompted to install the BlackBerry NDK.

The QNX Momentics IDE requires Java SE 6, which is included as part of the Oracle JDK. The Oracle JDK should already be installed since this is also a prerequisite for the Titanium SDK.

Each Titanium SDK supports a specific version range of the BlackBerry NDK.

Titanium SDK VersionMin BB NDK VersionMax BB NDK Version
3.1.3 - latest10.0.x10.2.x
3.1.210.0.x10.1.x

BlackBerry Device Simulator

The BlackBerry 10 Device Simulator runs on a virtual machine and requires one of the following:

BlackBerry Developer Certificates

To deploy to a device or package your application for distribution, you need to obtain signing keys from BlackBerry to create developer certificates. See BlackBerry Developer: Signing apps for more information.

 

 

Download both the Momentics IDE and BlackBerry 10 Device Simulator from http://developer.blackberry.com/native/download/.

iOS

See Installing the iOS SDK for detailed instructions.

Titanium requires Xcode to be installed in order for you to develop iOS applications.

There are two ways to obtain Xcode, the application that installs and manages iOS SDKs:

  1. Launch the App Store application, found in the Applications folder, and search for and install "xcode" (includes only currently-supported iOS SDKs).
  2. Enroll with the Apple Developer website and browse the iOS Dev Center page to manually download the installer application (includes all previously-released iOS SDKs, new and old).

Both of the above options are currently free of charge, although may require credit card details to be entered. If you wish to test your applications on a device, however, you will need to become a member of the iOS Developer Program, by way of an annual subscription charge of $99 at the time of writing.

Xcode

To develop for iOS, Titanium requires Apple's Xcode suite of tools.

Each Titanium SDK supports a specific range of Xcode versions, shown in the table below.

Titanium SDK Version

Min Xcode Version

Max Xcode Version

Notes

3.4.0 - latest6.0.x6.0.x 
3.2.2 - 3.3.05.0.x5.1.x 
3.2.0 - 3.2.15.0.x5.0.x 
3.1.35.05.0This release only supports Xcode 5.0 and not any of the 5.0.x versions.
3.1.0 - 3.1.24.34.6As of Release 3.1.0, the Titanium SDK no longer supports iOS development for ARMv6 devices, which includes the iPhone 2G/3G and iPod Touch 1G/2G.

2.1.3 - 3.0.x

4.2

4.6

To build the Titanium SDK 3.0.x with Xcode 4.2, use the legacy Titanium command-line tool. See Legacy Command-Line Interface for more information.

2.1.0 - 2.1.2

4.2

4.4

 

2.0.x

4.2

4.3

 

1.8.x

4.2

4.2

 

1.7.1+

3.2.6

4.2

 


Deploying for iOS 5.1 requires Xcode 4.3.
Deploying for iOS 6.0 requires Xcode 4.5.
Deploying for iOS 7.0 requires Xcode 5.0, and Mac OS X 10.8.4 and later.
Deploying for iOS 8.0 requires Xcode 6.0, and Mac OS X 10.9.4 and later. 

iOS SDK / Target iOS Platform

Each Titanium SDK supports a specific range of iOS base SDKs and deployment targets. To build an application for a specific iOS target version, you must have the appropriate iOS SDK installed. 

Titanium SDK version

Minimum SDK version

Maximum SDK version

Minimum target iOS version

Maximum target iOS version

3.4.0 - latest8.0.x8.0.x7.1.x8.0.x
3.2.2 - 3.3.07.0.x7.1.x6.1.x7.1.x
3.1.3 - 3.2.17.0.x7.0.x6.1.x7.0.x
3.1.1 - 3.1.25.0.x6.1.x5.0.x6.1.x
3.1.04.3.x6.1.x4.3.x6.1.x

2.1.3 - 3.0.x

4.0.x

6.1.x

4.0.x6.1.x

2.1.0 - 2.1.2

4.0.x

5.1.x

4.0.x5.1.x

2.0.x

4.0.x

5.1.x

4.0.x5.1.x

1.8.x

4.0.x

5.0.x

4.0.x5.0.x

1.7.1+

3.1.2

5.0.x

3.1.25.0.x

Mobile Web

Titanium SDK version 2.0 or newer is recommended for Mobile Web development. Mobile Web development does not require any additional tools or SDKs except for testing mobile web applications, which can be previewed either on a desktop browser or the Android emulator.

Note that the Mobile Web platform is designed to build applications for mobile browsers, not applications for desktop browsers. Desktop browsers are recommended only for previewing and debugging Mobile Web applications.

Desktop Browser

The following desktop browsers are recommended for previewing and debugging applications:

  • Google Chrome
  • Firefox (with Firebug extension)

Mobile Browser

For a list of supported browsers, see the Supported Browsers section in the Mobile Web Platform Overview.

Android Emulator

Refer to the Android requirements and instructions below for installing the Android SDK, which contains the Android emulator.

Other Useful Software

The following tools are required for native add-on module development or building the Titanium SDK from source.  These tools are not required for mobile application development with the Titanium SDK.

Git

Git is the optional, but highly recommended, way of obtaining and staying up-to-date with the latest mobile projects located in our Github repository.

Obtain the version that pertains to your particular Operating System from the link provided:

Operating System

Package Name

Package Version

Download Location

Notes

OS X

git

Latest

Official Website

 

Windows

msysgit

Latest

Official Website

On Studio 3.2.0 and later, portablegit is installed by default if no other Git client is installed.

Ubuntu

git

Latest

Default Repositories

 

See Installing Git for detailed instructions.

Python

Python is required to use Titanium from the command line or compile the SDK from source using SCons. Python is not required to use the Titanium SDK from inside Studio.

Titanium supports the following versions of Python for each respective Operating System:

Operating System

Package Version

Package Architecture Version

Download Location

OS X

2.x.x (currently, 2.7.x)

32bit and 64bit

Installed on OS by default

Windows

2.x.x (currently, 2.7.x)

32bit only

Official Python Website

Ubuntu

2.x.x (currently, 2.7.x)

32bit and 64bit

Default Repositories

Download the installer from the applicable download location above.

See Installing Python for detailed instructions.

Required Python Packages

Python's setuptools can be installed from the following locations:

Operating System

Package Version

Package Architecture Version

Download Location

OS X

Latest version compatible with installed Python version

32-bit and 64-bit

Installed on OS by default

Windows

Latest version compatible with installed Python version

32-bit only

Official setuptools Website

Ubuntu

Latest version compatible with installed Python version

32-bit and 64-bit

Default Repositories

See Installing Required Python Packages for detailed instructions.

SCons

SCons (Software Construction tool) is a build tool, similar to the classic make utility. It is used to build the Titanium SDK.

Installing scons is required if you want to build the Titanium SDK from source. It is not required for building, running, or distributing applications using the Titanium SDK.

Icon

Python is a prerequisite for SCons, and should be installed first. See Installing Python for instructions.

Obtain the SCons version listed below for your Operating System:

Operating System

Package Version

Download Location

OS X

Latest Stable

Official Website

Windows

Latest Stable

Official Website

Ubuntu

Latest Stable

Default Repositories

See Installing SCons for detailed instructions.

gperf

The GNU gperf utility is used for generating hash functions. It is used when you build Titanium native Android modules and and to build the Titanium SDK for Android.

The gperf tool is installed as part of the Xcode command-line tools, but you may need to install it on Linux or Windows.

gperf is not required for building, running, or distributing applications using the Titanium SDK.

Obtain the latest stable version of gperf.

Operating System

Package Version

Download Location

OS X

Latest Stable

Included with the Xcode developer tools.

Windows

Latest Stable

gnuwin32.sourceforge.net

Ubuntu

Latest Stable

Default Repositories or Official Website

See Installing gperf for detailed instructions.

Ant

Apache Ant is the standard build tool for Java. It can be used to build Titanium native Android modules and to build the Titanium SDK for Android. It is not required to build Titanium applications for Android.

You can also use Eclipse and ADT to build native Android code, as described in Installing Eclipse and ADT. If you are using Eclipse and ADT, Ant is optional, but you may want to install both (for example, to use Ant for command-line builds and Eclipse and ADT for debugging).

Ant is not required for building, running, or distributing applications using the Titanium SDK.

Icon

Java is a prerequisite for Ant, and should be installed first. See Installing Oracle JDK for instructions.

Obtain the latest stable version of Apache Ant. Ant is supplied as a multi-platform archive. You can choose the archive format that's easiest for you to extract: all archives contain the same files.

Operating System

Package Version

Download Location

OS X

Latest Stable

Official Website

Windows

Latest Stable

Official Website

Ubuntu

Latest Stable

Default Repositories or Official Website

See Installing Ant for detailed instructions.