grunt-tart v0.2.1

grunt-tart

tartJS + Cordova build plugin.

CAUTION!

Currently requires some grunt tasks/aliases to be installed and configured. Initial state intended to work in tartjs-mobile-demo only.

Getting Started

This plugin requires Grunt ~0.4.5

If you haven't used Grunt before, be sure to check out the Getting Started guide, as it explains how to create a Gruntfile as well as install and use Grunt plugins. Once you're familiar with that process, you may install this plugin with this command:

npm install grunt-tart --save-dev

Once the plugin has been installed, it may be enabled inside your Gruntfile with this line of JavaScript:

grunt.loadNpmTasks('grunt-tart');

"tart", the builder task

Overview

In your project's Gruntfile, add a section named tart to the data object passed into grunt.initConfig(). It is not necessary to add each Cordova platform as targets in order to build them. They are populated while grunt-task is loading.

grunt.initConfig({
  tart: {
    options: {
      compilerDefs: {
          'goog.DEBUG': false
      },
      cordova: {
        id: 'com.tart.example-app',
        name: 'Example tartJS App',
        path: 'target'
      }
    },
    ios: {
      options: {
        compilerDefs: {
          'goog.userAgent.ASSUME_WEBKIT': true
        }
      }
    },
    wp8: {
      options: {
        compilerDefs: {
          'goog.userAgent.ASSUME_IE': true
        }
      }
    },
  },
});

Note that objects under options are overridden completely when target option with same key defined. See grunt issue #738.

Options

options.compilerDefs

Type: Object.<String, [Boolean|String|Number]> Default value: { 'goog.DEBUG': true }

Closure Compiler definition key pairs. Can be changed via define cli flag:

grunt tart:ios --define="goog.DEBUG=false,goog.LOCALE=fr"

options.cordova

Type: Object Default value: { id: 'com.tart.example-app', name: 'Example tartJS App', path: 'target' }

These options passed into grunt-cordovacli task. See grunt-cordovacli options documentation for details.

Usage Examples

(Coming soon)

"plugin", the manager task

Overview

This tasks does not need any configuration.

Usage is simple as cordova plugin add/rm command:

grunt plugin:(add|rm):(plugin-id|git-url|eg: org.apache.cordova.device)[:version]

Omit version to download latest.

All added plugins will be persisted into package.json under cordovaPlugins.

Contributing

In lieu of a formal styleguide, take care to maintain the existing coding style. Add unit tests for any new or changed functionality. Lint and test your code using Grunt.

Release History

• v0.2.0 (06/12/2014 07:22)

  • Added 'plugin' task for managing Cordova plugins persisted in package.json.

• Initial release v0.1.0 (06/12/2014 02:36)