grunt-nw-gyp

Run nw-gyp commands from Grunt.

Getting Started

This plugin requires Grunt ~0.4.0

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:

1$ npm install grunt-nw-gyp --save-dev

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

1grunt.loadNpmTasks('grunt-nw-gyp');

For nw-gyp to work you’ll have to install all necessary build tools for your platform, see nw-gyp’s README.md for that matter. However, you do not have to install nw-gyp globally as it is already included with grunt-nw-gyp.

The “gyp” task

Overview

In your project’s Gruntfile, add a section named gyp to the data object passed into grunt.initConfig().

1grunt.initConfig({
2  gyp: {
3    options: {
4      // Task-specific options go here.
5    },
6    your_target: {
7      // Target-specific file lists and/or options go here.
8    }
9  }
10})

Options

command

Type: String Default value: rebuild

Specify nw-gyp command to execute.

Supported values are configure, build, clean and rebuild. See nw-gyp’s README.md for command descriptions.

options.debug

Type: Boolean Default value: false

Create a debug build.

options.arch

Type: String Default value: Your processor’s architecture

Set the target architecture: ia32, x64 or arm.

Usage Examples

Default Options

This would be equivalent to nw-gyp rebuild.

1$ grunt gyp:addon

1grunt.initConfig({
2  gyp: {
3    addon: {}
4  }
5})

Configure a debug build

This would be equivalent to nw-gyp configure --debug.

1$ grunt gyp:customTarget

1grunt.initConfig({
2  gyp: {
3    customTarget: {
4      command: 'configure',
5      options: {
6        debug: true
7      }
8    }
9  }
10})

Build an ARM build

This would be equivalent to nw-gyp build --arch=arm.

1$ grunt gyp:arm

1grunt.initConfig({
2  gyp: {
3    arm: {
4      command: 'build',
5      options: {
6        arch: 'arm'
7      }
8    }
9  }
10})

Running tests

First, install all dependencies:

1$ npm install

Then run the tests:

1$ grunt test

Testing might take a while as compiling takes time. You may need to install the node development header files before by executing:

1$ ./node_modules/.bin/nw-gyp install

Release History

• v0.5.0 (2014-12-02): Add arch option
• v0.4.1 (2014-08-25): Fix rebuild not stopping execution if one of the commands has failed
• v0.4.0 (2014-07-01): Update nw-gyp to v1.x
• v0.3.0 (2014-03-05): Update nw-gyp to v0.13.x
• v0.2.1 (2014-02-21): Hotfix because v0.2.0 didn’t include the main task file gyp.js
• v0.2.0 (2013-11-21): Update nw-gyp to v0.12.x
• v0.1.0 (2013-08-25): Initial release

License

grunt-nw-gyp is licensed under the BSD 2-clause license. See LICENSE for the full license.