Getting help overview

This guide walkthroughs the setup of Axway Appcelerator Studio (Studio). Although using Studio is not mandatory for mobile application development, which can 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 increase your productivity when building quality applications using Alloy and the Titanium SDK.

Compatibility and download

Use the latest stable version of Studio.

Sign up for an AMPLIFY Appcelerator Services account and log in to download the installer.

Preparing for Studio

System requirements

A system must satisfy the following requirements in order to run Studio.

Memory

Disk space

Operating system

Node.js

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 Studio

The installation procedure for Studio differs depending on the platform.

OS X

In addition to installing Studio, the installer for OS X also downloads and installs necessary third-party software that it requires, including the Java Development Kit and Node.js.

To install and run Studio on OS X using the GUI:

  1. Launch the Studio DMG you downloaded.
  2. Double-click the PKG file in the dialog.
  3. Click Continue.  The installer will check to see if the perquisites are met.
  4. After the check, the license agreement appears. Click Continue, then click Agree to accept the license agreement.
  5. Select a destination, typically this will be the Macintosh HD, then click Continue.
  6. Click Install to start the installation process.  The installer will install the prerequisites and Studio
  7. After installation is complete, click Close and eject the Appcelerator Studio volume.
     
  8. To start Studio, from the Dock, select Applications > Appcelerator Studio > AppceleratorStudio.

To install and run Studio on OS X using the CLI:

  1. Mount the DMG file using the hdiutil attach command.
  2. Run the installer using the installer command with sudo and specify the package and target using the -pkg and -target options, respectively.
  3. Enter your sudo password when prompted.  The installer will install the prerequisites and Studio.
  4. To start Studio, execute open /Applications/Appcelerator_Studio/AppceleratorStudio.app/.
$ hdiutil attach ~/Downloads/Appcelerator_Studio.dmg 
$ sudo installer -pkg "/Volumes/Appcelerator Studio/Appcelerator Studio.pkg" -target "/"
Password:
installer: Package name is Appcelerator Studio
installer: Upgrading at base path /
installer: The upgrade was successful.

Windows

In addition to installing Studio, the installer for Windows also downloads and installs necessary third-party software that it requires to run, including the Java Development Kit, Git, and Node.js.

To install Studio on Windows using the GUI:

  1. Launch the Studio installer you downloaded. You may be prompted throughout the installation to enter the system's administrator's password.
  2. Select the install location. By default, Studio is installed to %USERPROFILE%\AppData\Roaming\Appcelerator\Appcelerator Studio\ folder. 

    Installing Studio to a common system location (such as %PROGRAMFILES%) is not currently recommended as it causes problems during the Studio software update process.

  3. Check the I agree to the License terms and condition checkbox.
     

  4. Click the INSTALL button. The installer determines if the prerequisites are installed.  If not, the installer automatically installs them for you.
  5. Once the prerequisites are installed, the installer installs Studio.  When the installation completes, click Finish.
     
  6. To start Studio, double-click the Studio icon on the Desktop or the Start screen (on Windows 8). 

To install Studio on Windows using the CLI:

  1. Launch the Command Prompt as an administrator.  If you do not run as an administrator, the prerequisites will not be installed.
  2. Execute the AppceleratorStudio.exe executable with the /exenoui and /q flags.  The installer installs the prerequisites and Studio.
  3. To start Studio, execute the AppceleratorStudio.exe.
C:\Users\JDoe\Downloads>"Appcelerator Studio.exe" /exenoui /q
C:\Users\JDoe\Downloads>cd ..
C:\Users\JDoe>"AppData\Roaming\Appcelerator\Appcelerator Studio\AppceleratorStudio.exe"

Windows systems must have the following paths at the beginning of their PATH environment variable for Studio to function properly. Most modern Windows systems will already have these paths properly set.

%SystemRoot%\system32;%SystemRoot%;%SystemRoot%\System32\Wbem;

Launching Studio

Selecting a workspace folder

The first time you launch Studio you need to select a workspace, or folder where Studio stores your project files and IDE preferences. By default, Studio prompts you upon each launch to select a workspace.

  1. Click Browse to select a workspace folder to use.
  2. To hide this dialog on subsequent launches, select the  Use this as the default and do not ask again option.
  3. Click OK.

 

To select a different workspace folder at any time:

  1. Select File > Switch Workspace > Other... to open the Workspace Launcher.
  2. Click Browse....
  3. Browse to the new workspace folder and click Open.
  4. Click OK in the Workspace Launcher.

To re-enable the the workspace prompt on startup option:

  1. Open the Studio Preferences dialog.
  2. Select General > Startup and Shutdown > Workspaces.
  3. Enable the Prompt for workspace on startup option.
  4. Click OK.
  5. Restart Studio, which will prompt you for a workspace upon launch.

Logging in to Studio

On initial launch, Studio asks you to provide your AMPLIFY Appcelerator Services account credentials.  Studio requires an internet connection to authenticate the user to the Appcelerator cloud

  1. Enter your AMPLIFY Appcelerator Services credentials.
  2. Optionally click Proxy Setup... to configure your proxy settings if needed.
  3. Click Login.

Studio remembers your login credentials until you sign out of Studio.

Checking for Studio and SDK updates

When Studio launches for the first time, it automatically downloads the latest version all Appcelerator components. To confirm that your environment is up-to-date, select Help > Check for Appcelerator SDK Updates. This will install the latest versions of the following software:

Installing platform SDKs

To develop native applications with Titanium you need the SDKs and tools for those native platforms installed on your system. For example, to develop Android applications you need the Android SDK and toolchain installed.

The first time you launch Studio the Platform Configuration dialog opens. This dialog indicates which platform SDKs are installed and which are not, and lets you easily install individual SDKs. In the following screenshot, the system has none of the native SDKs installed.

To install the platform SDKs:

  1. Select the platforms you want to install.
  2. Optionally click Settings next to each platform to customize the installation configuration.  For more details, see Installing Platform SDKs.
  3. Click Configure to start the installation process.

Studio begins downloading and installing each SDK you selected, according to the settings you specified. In the case of iOS, Studio launches the App Store application installed on your Mac to the XCode download page.

Configuring advanced platform settings

Typically, you can use the Platform Configuration dialog to download and install mobile SDKs. The Preferences dialog to configure advanced settings for the platform SDKs.

To configure advanced platform settings:

  1. Open the Preferences  dialog:
  2. Navigate to the  Studio > Platforms  preferences section that contains sections for configuring each mobile platform SDK.

The section below describe the settings for each SDK.

Android settings

Under the Android settings item, you can configure the following settings:

To create a new Android emulator or modify an existing one:

To install additional Android SDKs:

To manage Android keystores for distribution:

iOS settings

Under the iOS item, you can configure:

Managing certificates, provisioning profiles and devices

The iOS settings also includes information about your iOS development certificates, provisioning profiles, and registered devices. It also provides easy access to the Apple Developer Center where you actually create your new certificates, provision profiles and register devices.

The  Certificates  section displays a list of your current certificates.

 

The Provisioning Profiles section displays a list of provisioning profiles for your development team or organization.

The Devices section lets you register a device for development. Click Register Devices... to open the Apple Deveoper

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.

Next steps - verifying Studio

Now that the setup is complete, verify that Studio is configured correctly by importing sample applications and creating new ones as described in Alloy Samples or Example Applications.