Titanium CLI is a Command Line Tool for creating and building Titanium Mobile applications and modules. It's open-source and easy to use. We've designed Titanium to be suitable for command line beginners, but still be powerful and extensible enough for production usage.
The Titanium CLI requires Node.js 0.8.x. You can download Node.js 0.10.x, but only Titanium SDK 3.1.0 and later will work.
[sudo] npm install -g titanium
You can download the latest and greatest unstable Titanium CLI code by running the following:
[sudo] npm install -g git://github.com/appcelerator/titanium.git
Obtaining a Titanium SDK
You will need to download a Titanium SDK 3.0 or newer:
# stable release (recommended) titanium sdk install --default
There are times when the latest stable release has an issue or lacks a feature in which case you may want to try an unstable Titanium SDK build. These builds are not recommended for production use, but should work for development.
# unstable next release titanium sdk install --branch 3_1_X --default # bleeding edge titanium sdk install --branch master --default
Setting up the Titanium CLI
Before you begin using the Titanium CLI, you should configure it by running the "setup" command:
It will prompt you with a number of questions such as your e-mail address (for logging into the Appcelerator Network), the location of your Android SDK, and so on.
titanium <command> [options]
Configure your CLI settings.
Implementation not complete
titanium config <setting> <value>
Displays help or help for a specific command.
titanium titanium help titanium --help titanium help <command> titanium <command> --help
Logs into the Appcelerator Network
Implementation not complete
Login requires both user and password options to be passed in.
titanium login <username> <password>
If you omit an option, the CLI will prompt you for the value.
Logs out of the Appcelerator Network
Implementation not complete
Download and install Titanium SDKs
Installs a specific version of the Titanium SDK. If no version is specified, it assumes the latest.
titanium sdk install titanium sdk install <version> titanium sdk install <version> --force
Download, install , and set as default SDK.
titanium sdk install <version> --default
Download and install the latest version for the specified branch
titanium sdk install --branch master
Uninstalls a Titanium SDK.
titanium sdk uninstall <version>
Lists all installed Titanium SDKs. Optionally lists all branches and releases.
titanium sdk list titanium sdk list -b titanium sdk list --branches titanium sdk list -r titanium sdk list --releases titanium sdk list -br titanium sdk list --branches --releases
Checks if there is a new version of the Titanium SDK available.
titanium sdk update
Download and install the latest version.
titanium sdk update --force
Download and install the latest version for the specified branch if not already installed.
titanium sdk update --branch master
Reconfigures the Titanium CLI by asking you a series of questions.
Indicates whether you are logged in or not.
titanium status titanium status --output json
Displays the current version of the CLI and exits.
titanium -v titanium --version
Displays information about your development environment including Xcode installs, iOS SDKs, Android SDKs, and so on.
titanium info titanium info -o json
Hacking the Titanium CLI
In order to begin hacking on the Titanium CLI, you need to download and install git.
If you have already installed a previous version of the Titanium CLI, it's recommended you uninstall the old one first:
[sudo] npm uninstall -g titanium
git clone firstname.lastname@example.org:appcelerator/titanium.git cd titanium npm install sudo npm link
Running Unit Tests
To run the unit tests, simply run:
node forge test
Running Code Coverage
To generate the code coverage, you first must install node-jscoverage. The easist way to do this is run:
git clone email@example.com:visionmedia/node-jscoverage.git cd node-jscoverage ./configure make sudo make install
node forge test-cov
It will generate a file called coverage.html in the Titanium CLI directory.
Looking for the really old CLI?
Don't worry, it's still around. You can install it by running:
[sudo] npm install –g firstname.lastname@example.org
Titanium is an open source project. Titanium wouldn't be where it is now without contributions by the community. Please consider forking this repo to improve, enhance or fix issues. If you feel like the community will benefit from your fork, please open a pull request.
To protect the interests of the Titanium contributors, Appcelerator, customers and end users we require contributors to sign a Contributors License Agreement (CLA) before we pull the changes into the main repository. Our CLA is simple and straightforward - it requires that the contributions you make to any Appcelerator open source project are properly licensed and that you have the legal authority to make those changes. This helps us significantly reduce future legal risk for everyone involved. It is easy, helps everyone, takes only a few minutes, and only needs to be completed once.
You can digitally sign the CLA online. Please indicate your e-mail address in your first pull request so that we can make sure that will locate your CLA. Once you've submitted it, you no longer need to send one for subsequent submissions.
This project is open source and provided under the Apache Public License
(version 2). Please make sure you see the
LICENSE file included in this
distribution for more details on the license. Also, please take notice of the
privacy notice at the end of the file.