Setting up Titanium Studio
Contents
Overview
In this guide, we help you to setup Titanium Studio, the extended version of the popular Aptana Studio IDE. Although using Titanium Studio is not mandatory, as this can indeed be done using a text editor and our command-line tools, we believe that it is the most effective way to speed up your development process and, thus, to increase your productivity when building quality applications using Titanium.
Compatibility and Download
It is advisable to use the latest stable version of Titanium Studio.
Please register for an Appcelerator Network account and log in to download the installer.
Preparing for Titanium Studio
System Requirements
A system must satisfy the following requirements in order to run Titanium successfully.
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) |
As a general rule, 2 to 3GB RAM is usually adequate to run the whole Titanium environment.
Operating System
Titanium is only supported when run on the following Operating Systems:
|
Operating System |
Min Version |
Max Version |
|
Apple Mac OS X |
10.6.x (Snow Leopard) |
10.7 (Lion) |
|
Windows 7 |
All |
Latest |
|
Ubuntu Linux |
10.04 LTS (Lucid Lynx) |
12.04 (Precise Pangolin) |
Oracle JDK
It is necessary for Oracle's Java Development Kit (JDK) to be installed in order to work with Titanium. This is because JDK is a prerequisite for Android development, and its subcomponent, the Java Runtime Environment (JRE), is required to run Titanium Studio.
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 |
6 latest revision |
32bit and 64bit |
Pre-installed |
|
|
Windows |
6 (aka 1.6) rev 10 |
6 latest revision |
32bit only (x86 / i586) |
32bit version of Java JDK is required regardless of whether Titanium is running on a 32bit or 64bit Windows system |
|
|
Ubuntu |
6 (aka 1.6) rev 10 |
6 latest revision |
32bit and 64bit |
Repository is configured by default but must be enabled. |
Obtain Oracle JDK from the download locations shown above.
Useful Software
Git (optional, but recommended)
Git is the optional, but highly recommended, way of obtaining and staying up-to-date with the latest Titanium 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 |
|
OS X |
git |
Latest |
|
|
Windows |
msysgit |
Latest |
|
|
Ubuntu |
git |
Latest |
Default Repositories |
See Installing Git for detailed instructions about how to install, including the program location and system environment variables that should be used.
Software Locations
The default and recommended software locations of a successful Titanium installation on each platform are described in Software Locations and Environment Variables.
Installing Titanium Studio
The installation procedure for Titanium Studio differs, depending on the platform.
OS X
-
once downloaded, open the Titanium Studio disk image (file with a .dmg extension) by double-clicking on it, and then open the resulting disk mount that will appear on your desktop
-
follow the instructions that display, instructing to drag the Titanium Studio folder icon in the installer's window image to the Applications directory in the OS X Dock
-
close the window when installation is complete
To start Titanium Studio, open the Applications > Titanium Studio > TitaniumStudio program.
Windows
Bear in mind the following caveats:
-
All Windows systems must have the following paths at the beginning of their PATH environment variable to function properly:
%SystemRoot%\system32;%SystemRoot%;%SystemRoot%\System32\Wbem; -
Installing Titanium Studio to a common system location, such as %PROGRAMFILES%, is not currently recommended, due to Eclipse Bug 249133 and the complications it causes with updates.
-
once downloaded, launch the installer and enter the administrator's password, if prompted
-
at Choose Install Location, you will notice that the destination path defaults to the Administrator's profile
-
delete the word, "Administrator", and replace it with your system username
-
proceed with the rest of the installation, click the Install button, followed by Next and Close
To start Titanium Studio, double-click the Titanium Studio icon that has been created on your desktop or use the one in the Start Menu
Linux
-
once downloaded, open the Titanium Studio .zip archive file by right-clicking on it and choosing the Extract Here menu option
-
open the resulting folder, and run the TitaniumStudio executable which may be used to launch the application
Launching Titanium Studio
-
you will be asked to Select a workplace where all your projects will be stored by default. Accept this filesystem path, and continue
-
enter your Appcelerator Network credentials
-
if your system does not have a direct connection to the internet, click "Proxy Setup..."
-
enter your proxy server's details, if necessary
Updating Titanium Studio
When Studio launches for the first time, it usually automatically starts installing the latest Titanium SDKs.
Once this is complete, confirm that no further updates are pending and that Studio is at the latest version.
-
run Help > Check for Updates to ensure that the latest version of Titanium Studio is installed
-
run Help > Check for Titanium SDK Updates to ensure that all the official Titanium SDK releases are installed
-
repeat these two steps until there are no more updates available
Configuring Titanium Studio
The Titanium Dashboard provides the easiest way to configure Studio's Titanium-related features and to access Appcelerator's Titanium online resources. It will display automatically the first time Studio is launched in a day.
Titanium Dashboard Configuration Wizard
-
if the dashboard is not already open, click the toolbar button with the Appcelerator logo
-
click the dashboard's "Configure" tab
-
click the "Let's get things set up!" button to begin installing and configuring the third-party SDKs
-
click the logo of the native SDK you would like to configure
iOS SDK Configuration (OS X-only)
In order to develop applications for Apple systems, such as iOS, Apple Xcode and iOS SDKs must be installed. To do this, click on the iOS icon, followed by the "Install iOS" button that appears on the right. The system's web browser will open, showing Xcode in the online Mac App Store.
-
click "View in Mac App Store", to launch the App Store application to the XCode page
-
start the Xcode download and complete the installation
When finished, return to the dashboard's Configure tab and click the iOS icon again to determine whether the Apple environment has been correctly installed.
If you don't see the "iOS SDK is installed correctly" message, then reinstall the environment.
Android SDK Configuration
After clicking on the Android icon on the dashboard's "Configure" tab, click on the "Install or Update Android SDK" that appears to the right.
-
when the Android SDK installer starts, set the destination directory
The Android SDK Manager will present a list of package categories.
-
select those supported by the latest official Titanium SDK, as described in the Titanium Compatibility Matrix
-
ensure that the Prerequisite Android SDK / API for the latest official Titanium SDK is selected
-
to reduce install time, expand each category and de-select unnecessary components, such as Documentation, Samples and Sources
-
click the Install x packages button
-
accept all the package licenses, by clicking the Accept All radio button
-
note any dependency warnings that appear at the bottom of the dialog
-
click each package with a missing dependency, and click the Reject radio button
-
once all the dependency warnings are resolved, click the Install button
-
click OK for any Site Authentication dialogs that appear
-
click OK and Close when the installation is complete
Verifying Titanium Preferences
Be aware that the Preferences menu is in a different location, depending on the platform.
-
on OS X, select Preferences from the Titanium Studio menu
OS X Menu Bar > Preferences
-
on Windows and Linux, use the Window menu
Windows Menu Bar > Preferences
Default Android SDK
If you intend to develop for Android, ensure that the Default Android SDK is correctly set to a SDK supported by the Titanium SDK you will be using most. All applications will use this SDK when they are first launched.
Troubleshooting
If you are having problems with any of the above steps, please see our Installation Troubleshooting guide or, otherwise, seek assistance in either our Q&A or one of our other help channels described in Getting Help.
Next Steps - Verifying Titanium Studio
Now that the setup is complete, verify that Studio is configured correctly by importing sample applications and creating new ones, as described in Creating Your First Titanium Apps.