You can build Tabris.js apps on your local machine using the Cordova command line interface.
This guide is for building apps locally with the command line. A guide covering the online build service can be found here.
If you’re targeting iOS you will need MacOS, while Android apps can be build on any OS that is supported by the Android SDK.
You also need a Cordova installation. Follow the Cordova Installation Guide and install the latest Cordova version on your system.
The Cordova CLI expects a standard directory layout. That is, the
config.xml is required at the root of the project and a
www folder must exist which contains your actual Tabris.js app.
/ |- cordova/ |- config.xml |- www |-- package.json |-- app.js
This directory structure can easily be created using the
cordova create command as described in the Cordova CLI Guide. After creating the project you will have a typical Cordova project layout including the
www directory. The default content which was created automatically is not needed and can be deleted.
Adding Tabris.js platforms
Tabris.js ships two custom Cordova platforms. This includes platforms for iOS and Android. Visit the Tabris.js download page and download the platform of your choice.
Extract the content of the downloaded archive and add the platform to your project using the
cordova platform add command. You need to append the path to the download platform. E.g.:
cordova platform add /Users/Me/Downloads/tabris-ios cordova platform add /Users/Me/Downloads/tabris-android
or for Windows users:
cordova platform add c:\MyDownloads\tabris-android
Integrate Cordova Plugins
You can integrate all available Cordova Plugins using the
cordova plugin add command. Read the Cordova Plugin Installation Guide for a detailed description of this command.
An example of adding the Cordova Camera Plugin will result in this command:
cordova plugin add org.apache.cordova.camera
Important: You can install all available Cordova Plugins. Most of the Plugins will work out of the box but not all. This is because Tabris.js uses a native UI and no HTML5. As a result all Plugins that manipulate the DOM will not work.
The Application Code
The code of a Cordova Application is placed in the
www directory. This is where you need to place your Tabris.js project files (
node_modules folder, and all your own modules and resources).
Building/Running an App
To run an app, use the
cordova run command as described in the Cordova Emulator and Device Guide.
Building an app is just as simple. Use the
cordova build command as described in the Cordova Build Guide.