This guide describes where to obtain and how to install the Xcode suite of developer tools including iOS SDKs.
Compatibility and Download
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:
- Launch the App Store application, found in the
Applicationsfolder, and search for and install "xcode" (includes only currently-supported iOS SDKs).
- 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.
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
|5.0.0 - 5.3.1||6.0.x||7.3.x|
|4.0.0 - 4.1.x||6.0.x||6.4.x|
|3.4.0 - 3.5.x||6.0.x||6.0.x|
|3.2.2 - 3.3.0||5.0.x||5.1.x|
|3.2.0 - 3.2.1||5.0.x||5.0.x|
|3.1.3||5.0||5.0.x||This release only supports Xcode 5.0 and not any of the 5.0.x versions.|
|3.1.0 - 3.1.2||4.3||4.6||As 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
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
Deploying for iOS 8.0 requires Xcode 6.0, and Mac OS X 10.9.4 and later.
Deploying for iOS 9.x requires Xcode 7.x, and Mac OS X 10.11 and later.
Deploying for iOS 10.x requires Xcode 8.x, and Mac OS X 10.11.5 and later.
Deploying for iOS 11.x requires Xcode 9.x, and Mac OS X 10.11.5 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
|6.0.0 - latest||8.0.x||10.x||8.0||10.x|
|5.0.0 - 5.5.1||8.0.x||9.3.x||7.1.x||9.3.x|
|4.0.0 - 4.1.x||8.0.x||8.4.x||7.1.x||8.4.x|
|3.4.0 - 3.5.x||8.0.x||8.0.x||7.1.x||8.0.x|
|3.2.2 - 3.3.0||7.0.x||7.1.x||6.1.x||7.1.x|
|3.1.3 - 3.2.1||7.0.x||7.0.x||6.1.x||7.0.x|
|3.1.1 - 3.1.2||5.0.x||6.1.x||5.0.x||6.1.x|
2.1.3 - 3.0.x
2.1.0 - 2.1.2
Note that the typical filesystem location of this software can be found in the OS X Software Locations section of these guides.
To install the current version of Xcode, use the Mac App Store:
- Launch the App Store application from the Applications folder
- Search for "Xcode"
- Click the Free button, then Install App button
The App Store starts the download and installation process.
To install previous versions of Xcode, download and run the installer application from iOS Dev Center: Downloads for Apple Developers.
- Go to https://developer.apple.com/downloads/ (Requires an Apple Developer account)
- Search for "Xcode"
- Locate the Xcode version you want to install and click the link to start downloading it.
- Once the download completes, launch the installer application and follow the directions.
To confirm that Xcode has been installed correctly, launch it from Applications.
Update Xcode using Xcode Installer
When new versions of the SDK are released, launch the App Store and click the Updates icon. If Xcode appears, click the Update button.
Install the Command Line Tools and Previous Simulators
The Xcode command-line tools are required for native add-on module development and recommended to be installed for mobile application development. You can either install the command-line tools from Xcode or by running the xcode-select command from a terminal.
To install the command-line tools or older simulator from Xcode:
- Launch Xcode.
- Select Xcode > Preferences.
- Select the Download icon and click the Install button next to the Command Line Tools item.
- If desired, you can install older simulators.
To install the command-line tools from a terminal, run the following command:
Select the Active Xcode Version
For systems with multiple Xcode versions installed, the current version can be selected by running
sudo xcode-select at the command-line.
If you are using Studio, you need to restart Studio for your changes to take effect.
Configure Studio or the CLI
Both Studio and the CLI use the
xcode-select command to obtain the location of the Xcode tool to use when building your iOS applications. Neither tool requires any additional configuration.
For Studio 3.1.0 and later, you can select a default iOS simulator type to launch after building your application. Open the Preferences dialog by selecting Appcelerator Studio > Preference from the menu bar, then navigate to Studio > Platforms > iOS and select a simulator type from the Default Display drop-down menu.
Note for Mavericks
If you are using Mac OS X 10.9 (Mavericks) and packaging an iOS application to the iTune Stores, after the Xcode Organizer is launched, a dialog from OS X may open stating, 'UI element scripting is not enabled. Check "Enable access for assitive devices"'.
This message is misleading as this was the name of the setting in previous versions of Mac OS X, which is already enabled by default on the older versions.
On Mavericks, to fix this issue:
- Open System Preferences from the Apple Menu.
- Click Security & Privacy.
- Click the Privacy tab.
- If the dialog is locked (bottom-left corner), unlock it.
- Click Accessibility from the left list.
- Enable either Terminal (if you are using the Titanium CLI), TitaniumStudio or AppceleratorStudio.
- Close the System Preferences.