Due to Apple's terms and conditions, the iOS SDK may only be installed on Apple products, hence only instructions for installing to Apple's macOS operating system are provided here.
This guide describes where to obtain and how to install the Xcode developer tools including the iOS and watchOS SDKs.
Titanium requires Xcode to be installed in order for you to develop iOS applications.
Both of the above options are free of charge, although may require credit card details to be entered. Since 2016, you can also test your apps on your device using the free Apple developer program. If you wish to deploy your applications to the App Store for production, 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.
Supported versions of Xcode
Unsupported versions of Xcode
Deploying for iOS 11.x requires Xcode 9.x, and macOS 10.12.4 and later.
Deploying for iOS 12.x requires Xcode 10.x, and macOS 10.13.6 and later.
As per apple guidelines, Starting April 2020 all apps submitted to App Store must be built with iOS 13 SDK or later, included in Xcode 11 or 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.
Supported versions of iOS SDK / Target iOS platform
Unsupported versions of iOS SDK / Target iOS platform
Note that the typical file system location of this software can be found in the mac OS Software Locations section of these guides.
To install the current version of Xcode, use the Mac App Store:
The App Store starts the download and installation process.
To install previous versions of Xcode, download and run the installer application from iOS Developer Center: Downloads for Apple Developers.
To confirm that Xcode has been installed correctly, launch it from Applications. When installing Xcode the first time, you are also prompted to accept the End User License Agreement (EULA) and are being asked to installed required components. These will be downloaded once accepted.
When new versions of the SDK are released, launch the App Store and click the Updates icon. If Xcode appears, click the Update button.
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:
To install the command-line tools from a terminal, run the following command under "sudo" permissions:
sudo xcode-select --install
For systems with multiple Xcode versions installed, the current version can be selected by running
If you are using Studio, you need to restart Studio for your changes to take effect.
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.
You can select a default iOS simulator type to launch after building your application. Open the Preferences dialog by selecting Axway 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.
If you are using maxOS 10.9+ and packaging an iOS application to the iTune Stores, after the Xcode Organizer is launched, a dialog from your maxOS 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 macOS, which is already enabled by default on the older versions.
On Mavericks and later, to fix this issue: