Titanium Tips

Modules - Installation

Update 20 June 2011 - Titanium+Plus Modules are now available as part of paid Indie, Professional and Enterprise subscription plans. Visit this page for details.

Appcelerator recently announced some great new modules that add extra functionality to an already very capable Titanium Mobile system.

Appcelerator has released three open-source modules (Paint, Flurry and AdMob) that are free for any of us to use, along with 13 different Titanium+Plus paid modules.

Appcelerator’s pricing information for the Titanium+Plus modules is a bit sketchy at the moment, but hopefully Appcelerator will come up with some sort of one-off payment to access an individual module - that would be something I’m sure a lot of developers would be willing to pay for.

Anyway, the important thing for the time being is to get stuck in and try out these new modules! Here’s how to get started...

1. First off, download one of the modules. The three open-source modules can be downloaded by anyone here, but to use the 13 Titanium+Plus modules, you’ll have to log into your account at the Appcelerator Developer Center and then visit this page. You don’t have to pay any money to test out the Titanium+Plus modules, but a big red warning message will show when you start any app that uses these modules. So if you want to get rid of the message, you’ll have to buy a subscription to use the module.

2. The modules are downloaded as zip files, so expand the zip file if it hasn’t automatically been expanded. You should now have a folder called modules. Inside this folder there should be another folder called iphone. Inside the iphone folder there should be another folder called ti.[name of module]. (e.g. if you downloaded the Paint module, the folder should be called ti.paint.)

3. Navigate to your /Library/Application Support/Titanium/modules folder. If there is not an iphone folder already inside the modules folder, create it. You should now have a setup similar to the image below.

Where to install your modules

4. Drag the ti.[name of module] folder inside this iphone folder.

5. Your module is now installed. If everything is correct, you should have a setup like in the screenshot below.
Available modules path
(Note that in this screenshot, both the Titanium+Plus Barcode module and the open-source Paint module have been installed. Inside the ti.barcode and ti.paint folders, you’ll find some documentation and an example app.js file that you can use to test out the module functionality.)

6. Now that your module is installed, you can read this post on how to actually get that module working in a Titanium Mobile project.