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


Errors while building a Titanium project are usually due to configuration issues. The most common problems and possible solutions are posted here.

Run/Debug icons are greyed out

This occurs when a project isn't recognized as a Titanium project. You can check whether the project has the correct type by looking at the project folder in the Navigator or Project Explorer view. If the type is set correctly, the folder should have an "M" icon (for Mobile) or a "D" icon (for Desktop). If the icon is missing, the project type is set incorrectly.

  1. Follow the steps in Changing Your Project Type, choosing the settings for Titanium Mobile or Titanium Desktop.
  2. After changing the project type, you may need to restart Studio.

Build error in console output

Sometimes your project fails to build, but it's not clear if it's an issue with Studio, or perhaps there is a bug in the SDK. To isolate this problem, you can try building from the command line using the exact same parameters as Studio.

  1. Open the Studio Preferences dialog and navigate to Studio > Troubleshooting.
    1. Push the slider all the way to the right to "All"
    2. Check on "debug specific components"
    3. Check on "com.aptana.core/debug/shell"
  2. Save and exit the preference menu
  3. Re-run the build. View the Studio log file (Help > Studio > View Log file)
  4. You should see an entry like:

  5. Open a terminal window and paste in the first line (the whole line, starting with the reference to Python), as shown below:

Does the process give the same error?

Build error: No such file or directory

This can be caused by a few different issues:

  1. You are running an incompatible version of XCode. Upgrade to the latest version.
  2. You have not correctly installed the Java JDK.

Build Error: iOS Module: No module named tools

When building an iOS module, you may run into the following error:

There are two possible fixes.

  1. Check your module.xcconfig. It may be that TITANIUM_SDK_VERSION and TITANIUM_SDK point to the wrong version or location.
  2. Create a new project and copy over the build.py from that new project to yours. It could be your build script is out of date.


When launching an Android application on the emulator, you may run into the following error:

There are a few possible fixes.

  1. Check that your launch configuration uses the 'Google APIs' Android version (e.g. 'Google APIs Android 2.2').
  2. Kill the emulator (adb) process, and relaunch the application through your launch-configurations.

Xcode not installed

Studio reports that Xcode is not installed, even though you believe it is. This appears to be caused by a bad install of Xcode. Uninstalling and re-installing Xcode has fixed the issue in every case so far.

You can double check the install location of Xcode by typing the following in Terminal:

Which should print something like '/Developer'

The directory ... contains 2 projects

This can happen when renaming an application. To fix this, delete the contents of build/iphone and re-build.

  • No labels