Getting Started
This page explains how to install and configure JavaScript Build Eclipse. This Eclipse plugin is based on tern.java.
To install JavaScript Build Eclipse, please read Installation - Update Site section.
JavaScript Build Eclipse provides features for Grunt and Gulp:
- completions, hyperlink, hover, validation inside JavaScript editors for Grunt and Gulp.
- Build explorer view to display in a tree Gruntfile.js, gulkpfile.js 's task / targets and execute it with Eclipse launch.
To load tasks / targets from Gruntfile.js, gulpfile.js, JavaScript Build Eclipse uses tern plugins tern-grunt and tern-gulp. So to use it, you must
- convert your project to Tern :
- this action open Tern project properties. You must select grunt / gulp module :
Check that Node.js tern module is selected too because tern-grunt and tern-gulp are linked to this tern module.
If you open a Gruntfile.js / gulpfile.js, you will benefit with completion :
You can see Grunt / Gulp tasks in a tree to open it and run it :
- with standard Project Explorer view :
- or with custom Build Explorer view :
If your file is named with Gruntfile.js or gulpfile.js and you have converted your project to tern and check the well tern plugin (see prerequisite), you can expand the tree of the Gruntfile.js / gulpfile.js to see in the tree the tasks that you can open it or run it :
To open Build Explorer view, you must go at Window / Show View / Others... and select JavaScript / Build Explorer menu item :
If your project is converter to Tern project and you have selected the well tern modules (grunt or gulp), you can add your file Gruntfile.js or gulpfile.js to the Build Explorer by dragging / drop the file from the Project Explorer to the Build Explorer (or use the Add Buildfiles button, the first button of the view) :
If your Gruntfile.js, gulpfile.js is not inserted in the view or if the view doesn't display your targets, please check your project is a tern project which have grunt / gulp tern module.
You can navigate to the task definition by using the contextual menu Open With :
To execute task, you must double click on a task of the tree.
You must install client :
- for grunt : the Grunt Command Line Interface is implemented in the
grunt-clipackage which should be installed globally to execute tasks / targets. Open a dos/sh command and type :
npm install -g grunt-cli
- for gulp : Open a dos/sh command and type :
npm install -g gulp
When you double click on a task, it creates an Eclipse launch and the result is displayed in the Console View :