模块(Modules)对Titanium的一些SDK以及特定的硬件进行了封装,提供了一些接口方便我们调用。使用模块可以增加应用程序的功能,同时我们也可以开发自己的Titanium模块。今天我们先来看看怎么使用Titanium模块。
获取Titanium模块主要有几个途径:
gitTio! (maintained by Fokke Zandbergen) lists all Titanium modules and Alloy widgets available on Github at http://gitt.io/
ClearlyInnovative (Aaron Saunders) has published various modules at http://www.clearlyinnovative.com/
Ben Bahrenburg publishes various iOS modules at http://bencoding.com/ or https://github.com/benbahrenburg
QuickTiGame2d is a 2D game engine module for Titanium http://code.google.com/p/quicktigame2d/
以barcode模块为例,首先上https://github.com/appcelerator/titanium_modules/tree/master/barcode将代码下载下来。分别在android和ios文件中找到ti.barcode-android-2.3.4.zip和ti.barcode-iphone-1.8.3.zip两个文件,记下两个路径。
在Titanium Studio菜单中,依次选择Help > Install Mobile Module,在路径一栏点击Browse查找到上一步的zip文件,两个zip文件要分两次操作。Output Location可以选择全局安装模块或者只针对某个项目安装,还可以安装到特定目录下。全局安装的时候模块的安装路径在mac下为:
~/Library/Application Support/Titanium(OS X 10.7及之后)
/Library/Application Support/Titanium(OS X 10.6及之前)
这样就安装成功了。
在每个项目的tiapp.xml文件中
点击添加按钮
选择自己需要的模块,可以看出有些模块只能在特定的平台下使用。或者在xml文件中以标签的形式添加:
<modules> <module platform="iphone">ti.barcode</module> <module platform="android">ti.barcode</module> </modules>Titanium Studio默认使用模块的最新版本,可以在tiapp.xml中双击模块名称来选择版本。
在程序中引用模块使用require语句:
var Barcode = require('ti.barcode');接着就可以调用模块提供的一些接口了:
Barcode.capture({ animate: true, overlay: overlay, showCancel: false, showRectangle: false, keepOpen: true/*, acceptedFormats: [ Barcode.FORMAT_QR_CODE ]*/ });