- Example Module Use
You can install a module so that it is available to a single project, or all projects you create. Then you will see how to use a module within your project.
You can install a module for a single project, or that all Studio projects can use. Once you've installed the module, you then configure it for use in your project (see Configuring your app to use a module).
To install a module:
- In Studio, select Help > Install Mobile Module.
- In the Module dialog, enter the URL of the module's ZIP file, or click Browse and locate the ZIP file.
- For Output Location select one of the following:
- To install the module so it's available to all projects, select Titanium SDK. See Module install locations.
- To install the module so its available to a single project, select Mobile App Project, and then choose the desired project from the pop-up menu.
- To install the module to a folder location, select Location and then browse to the desired output folder.
- Click OK.
Module install locations
When you install a module that's available to all projects, the module is installed to one of the following locations, depending on your platform.
Configuring your app to use a module
Once you have installed the module, you must configure your application to use it. This involves two steps:
- Add the module as a dependency in your application's
- Call the
Updating the tiapp.xml file
You can update your application's tiapp.xml file visually, or manually in a text editor.
To add a module to your project:
- In Studio, open your project and double-click its tiapp.xml file.
- Click the Overview tab in the bottom-left of the Editor window.
- In the Modules section, click the green add ( + ) button.
- Select the module you want to add and click OK.
Note the version numbers listed at the bottom of the dialog. See Selecting a module version.
- Save your changes to tiapp.xml.
To manually add a module to your project's tiapp.xml file, modify the
<modules/> tag in the
<ti:app> node as follows:
Selecting a module version
A installed module may include one or more versions that your application can use, as well as versions for production, deployment and testing. By default, Studio selects the latest version of a module when you install it.
To select a specific module version:
- In the Modules section of tiapp.xml, double-click on the module to opens the Module Properties dialog.
- For each platform, select the version of the module you want to use.
- Click the arrow next to the platform to expand it to select to use the module for specific build types.
- Click OK.
- Save tiapp.xml.
require() to load the module in the app's code in ES5
import() to load the module in the app's code in ES6+
In addition to the ES5-styled
require() function, you can also import modules using the
Finally, you'll use the module's object, properties, and methods to enable its features and functionality. Each module distributed in the Marketplace should include documentation and a sample app that demonstrates the basic use of the module. That information would be a great place to start with learning how to use a specific module.
Example Module Use
The following section illustrates how you would use one of the modules included in the Titanium Plus set.
For this example we will be downloading the AdMob module for iOS available on GitHub. While the example covers an iOS use case, the same general steps apply to an Android module. The ZIP file containing the module distribution can be downloaded here.
Install the module as described above.
Require the module in your project with the following code:
You can now call methods on the admob singleton object:
Requested module could not be found
If you receive an error saying: "Requested module not found." Check the name and version number of the module in the
tiapp.xml file. Make sure that the version of the module is installed either locally or globally. You can also remove the
version attribute from the
module element to use the most recent version of the module.
In this section, you learned that you can install a module for use by a single project or by all projects that you develop on a computer. Once installed, you have to modify your app's tiapp.xml file to support the module. Then, you must require the module into your app's code before you can implement its functionality.