继续上一篇Tabris.js 介绍与学习<2>的学习
这一篇,我们将讲解如何将我们开发好的工程打包。官网的指导在这里
Tabris.js是利用 Apache Cordova来构建和打包应用的。应用可以在线免费构建,而不必任何的本地设置。当然,如果你想在本地构建和打包应用的话,你得付钱,然后配置本地构建环境。
注意:在线构建服务只对公开的Github仓库免费。
一.工程布局
在构建你的工程之前,你得创建一个名叫cordova
的子目录,里面包含了构建的配置说明。Tabris.js工程的布局像下面这样:
1.config.xml
需要的最小的构建配置是config.xml
文件,描述你的应用,它包含了应用的id,版本号,图标和splash screens。config.xml
文件的格式和标准的Cordova config.xml
是一样的。最简洁的配置文件如下:
<?xml version='1.0' encoding='utf-8'?>
<widget id="my.first.app" version="1.0.0">
<name>HelloWorld</name>
<description>
A sample Tabris.js application.
</description>
<author email="dev@tabrisjs.com" href="https://tabrisjs.com">
Tabris.js Team
</author>
</widget>
2..tabrisignore
文件
构建服务会将你的工程内容打包到应用中,如果某些文件不需要的话,你可以把它们列在.tabrisignore
文件中,书写格式和.gitignore
文件是一样的。
3.构建服务
Tabrisjs.com提供了一个免费的在线构建服务。登陆tabrisjs后,选中My Apps
部分,点击Create App
来创建一个应用。现在你可以在你的仓库列表中选择你的工程仓库(创建好Tabris.JS工程后,要上传到Github,这样才能利用服务构建应用)。
选中仓库后,在线服务就会对选中的仓库进行验证,检查一下选中的仓库是否包含有效的Tabris.js工程布局。
验证成功后,就准备构建应用程序了。选中刚创建的应用,点击Start Android Build
按钮,如果没问题的话,几分钟后,你便会得到一个.apk
文件,能够运行在你的Android设备上。
那么对于iOS呢?因为需要证书等因素,所以可以通过Settings
来配置。
注意:
在线构建服务会自动帮我们安装在package.json
文件中声明的依赖项(devDependencies
类型的依赖项不会安装),所以你不需要将node_modules
文件夹放入Github中。
3.Settings
Repository URL
:你的Git仓库的地址,如果你使用免费服务类型的话,请填写一个公开的仓库地址。SSH Private Key
:获得你仓库的SSH私有秘钥,没有托管在Github上得Git仓库才需要填写Branch
:从哪个Git分支中构建应用,默认是master
。App Directory
:在你的仓库中包含Tabris.js
应用的目录,值必须要相对于你的仓库根目录来说的,不填写的话,默认是仓库根目录iOS Signing Key
:如果没有签名的话,iOS应用是不能部署到苹果设备上的。如果你想构建一个iOS应用的话,你需要一个苹果开发者账号,来提供一个证书与配置文件。那么如何得到这些文件呢?请看Phonegap Build documentationAndroid Signing Key
:如果你需要将应用部署到Google Play上得话,Android应用也需要证书签名。那么如何得到这些东西呢?请看Phonegap Build documentationEnvironment Variables
:键值对将会被存储并且会编码,然后传输到构建的机器上。Builds to keep
:声明在自动删除之前,应当维持构建的次数Tabris.js Version
:在应用中使用的Tabris.js
客户端版本。除了package.json
文件中的tabris
依赖项可以定义JavaScript模块的版本外,这个设置可以定义本地客户端的版本。大多数情况下,latest
值就足够了,但是如果你想要稳定版本的话,你可以在这里定义。Debug
:设置为debug模式。如果设置为ON
,应用构建时会带有调试符号,它会被打包到开发者应用中来让开发变得容易些。注意,debug模式下的应用不会被提交到应用商店。Debug值设置为OFF
意味着你的应用准备发行了:没有开发者应用,没有控制台,没有重新加载。
4.添加插件
为了添加Apache Cordova Plugins(插件)
,你只需要将它们添加到config.xml
文件中,在线构建支持Cordova的<plugin>
标签。这个标签允许你通过使用ID、HTTP或者Git URL来添加插件。包含两个Cordova插件的config.xml
示例入下:
<?xml version='1.0' encoding='utf-8'?>
<widget
id="my.first.app"
version="1.0.0"
xmlns="http://www.w3.org/ns/widgets"
xmlns:cdv="http://cordova.apache.org/ns/1.0">
...
<plugin name="cordova-plugin-camera" version="1.2.0" />
<plugin name="cordova-plugin-dialogs" version="1.1.1" />
</widget>
5.配置
处理第三步介绍的设置外,Tabris.js也会将下面的config.xml
属性用到账号中,在线构建和本地构建都适用。
content
在普通的Cordova 应用中,可选的<content>
元素定义了应用的起始界面。在Tabris.js中,你可以用它来定义www
文件夹中package.json
文件的位置。例如:<content src="mySubFolder/package.json"/>