使用Titanium模块

        模块(Modules)对Titanium的一些SDK以及特定的硬件进行了封装,提供了一些接口方便我们调用。使用模块可以增加应用程序的功能,同时我们也可以开发自己的Titanium模块。今天我们先来看看怎么使用Titanium模块。

        获取Titanium模块主要有几个途径:

  1. Appcelerator Marketplace:https://marketplace.appcelerator.com/ ,这上面既有免费的也有收费的模块,有官方开发的也有个人开发的,下载或者购买模块后,当有更新时会收到邮件通知。有些模块会在项目编译的时候检查是否有权限使用这个模块。
  2. github上开源的模块:https://github.com/appcelerator/titanium_modules,这上面的模块较少,且官方不提供支持。
  3. 其他一些社区成员开发的,如
    • 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文件中


        点击添加按钮


使用Titanium模块_第1张图片

        选择自己需要的模块,可以看出有些模块只能在特定的平台下使用。或者在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
        ]*/
    });

你可能感兴趣的:(android,modules,Titanium)