Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: minor tweaks

...

Follow the instructions on http://gitt.io/cli.

Installing Modules

Once a module is downloaded, it must be installed in a specific project or in a shared global location.

...

  1. Open Studio.
  2. Expand the project folder in the Project Explorer view.
  3. Drag the .zip file from the download location into the current project, placing it at the root of the project. Choose to "Copy Files".

Automatic Unzip

Place the module zip file in the root of the project directory. The Titanium build will automatically extract all registered Titanium modules in the root of the project.

Manually Unzip

Extract the .zip file into the root of your project. It should extract into the modules/<platform>/<module-id>/<version> directory.

Global Installation

Modules can be globally installed in the following locations:

...

  1. Open the module's .zip file, and look at the folder structure. The path will look like the following:

    Panel
    • Folder Structure: modules/<platform>/<module-id>/<version>
    • Example: modules/ios/ti.greystripe/1.1
  2. Open Studio, and the tiapp.xml file for the project in question.
  3. Switch to the tiapp.xml tab.
  4. In the application's tiapp.xml, find the <modules/> node, and replace it with the new <modules> content. If you already have modules, just add a new node for the new module. Note that the "version" and "platform" attributes are optional. When "version" is not specified, the latest version of the module will be used (as of Titanium SDK 2.0.0), and the "platform" tag is only necessary when using a module that is not available on both platforms.

    Code Block
    linenumberstrue
    languagexml
    <ti:app>
      <!-- $MODULE_VERSION should be the same as "version" from above -->
      <modules>
        <!-- For example, if we were adding the greystripe module: -->
        <module version="1.1" platform="ios">ti.greystripe</module>
      </modules>
    </ti:app>
    
  5. Use the require function to load the module in the app's code, for example:

    Code Block
    languagejs
    var Module = require('$MODULE_ID');
    
    // For example, to load the greystripe module:
    var greystripe = require('ti.greystripe');
    
  6. The next time the app is launched or built, the module should be included with the application.