前端开发神器：grunt快速入门

grunt是什么？

grunt是一个基于nodejs的task runner，简单来讲，就是相似于.net平台的msbuild以及java平台的maven。

grunt能作什么？

grunt可使你的项目中重复的任务，好比压缩，语法检查，编译（好比LESS预处理，coffeescript编译），单元测试等变得更加简单。

安装

由于grunt是基于node.js的，因此咱们首先要安装node.js以及node.js的包管理工具npm。

windows 平台下只要在NODE.JS官方下载MSI安装包，直接安装，node.js以及npm就能直接装好。

Linux平台下，由于一些发行版软件源的node.js版本想对比较低，grunt 0.4又要求node.js的版本要>=0.8.0，所以我推荐编译安装。

安装完成node.js之后，就能够开始安装npm，grunt以及grunt-cli了。

sudo apt-get -y install npm
sudo npm install -g grunt
sudo npm install -g grunt-cli

Getting started

配置文件

grunt须要两个配置文件：Gruntfile.js以及package.json。

Gruntfile.js

Gruntfile.js要放在项目的根文件夹下，用于配置grunt要运行的任务：

module.exports = function( grunt ) {
    grunt.initConfig({
      pkg: grunt.file.readJSON('package.json'),
      uglify: {
        options: {
          banner: '/*! <%= pkg.name %> <%= grunt.template.today("yyyy-mm-dd") %> */\n'
        },
        build: {
          src: 'src/<%= pkg.name %>.js',
          dest: 'build/<%= pkg.name %>.min.js'
        }
      }
    });
    grunt.loadNpmTasks('grunt-jsdoc');
}

NOTE：

经过<%%>模板字符串能够引用任何的配置属性，好比<%=pkg.name%>

经过grunt提供的API方法loadNpmTasks，咱们能够加载grunt的插件

grunt.loadNpmTasks('grunt-jsdoc');

package.json

package.json用来存放项目的元数据，好比项目的版本，项目许可证书——好比MIT，GPL啥的，做者，项目依赖的库等：

{
  "name": "ui",
  "version": "1.0.0",
  "description": "",
  "main": "ui.min.js",
  "directories": {
    "doc": "doc"
  },
  "scripts": {
    "test": "echo \"Error: no test specified\" && exit 1"
  },
  "repository": "",
  "keywords": [
    "javascript",
    "ui",
    ""
  ],
  "author": "",
  "license": "BSD",
  "devDependencies": {
    "grunt": "~0.4.1",
    "grunt-jsdoc": "~0.4.0",
    "grunt-contrib-copy": "~0.4.1"
  }
}

当你准备开始使用grunt去作一个新项目的时候，你可使用npm init来建立一个基本的package.json文件。

grunt的任务

Grunt就只支持两种任务，分别是基本的Task以及MultiTasks。这二者的区别是：Basic Task的任务配置只有一个，而MultiTasks的任务配置则有多个。

默认状况下，若是没有指定MultiTasks要使用的目标配置，那么实际执行任务的时候，grunt会加载而且执行全部的任务配置。大多数的grunt插件任务都是MultiTasks。

咱们以grunt-jsdoc插件做为例子，实际观察一下MultiTasks的运行：

// grunt-jsdoc插件的任务配置
jsdoc: {
    dev : {
        src: jsdoc_src, 
        options: {
            template : 'templates/ebaui',
            private    : false,
            destination: 'build/doc/',
            tutorials  : 'build/demo/'
        }
    },
    release : {
        src: jsdoc_src, 
        options: {
            template : '',
            private    : false, 
            destination: '../release/<%=pkg.version%>/doc/',
            tutorials  : 'build/demo/'
        }
    }
}

没有指定任务的目标配置

运行任务：

grunt jsdoc

在console里会输出以下结果：

Running "jsdoc:dev" (jsdoc) task
Documentation generated to E:\mygit\eba.ui\trunk\build\doc
Running "jsdoc:release" (jsdoc) task
Documentation generated to E:\mygit\eba.ui\release\1.0.0\doc
Done, without errors.

指定任务的目标配置

运行任务：

grunt jsdoc:dev

在console里会输出以下结果：

Running "jsdoc:dev" (jsdoc) task
Documentation generated to E:\mygit\eba.ui\trunk\build\doc
Done, without errors.

编写grunt任务

grunt全局命名空间下，提供了如下两个和定义任务有关的API：

//  Alias task
grunt.registerTask(taskName, taskList)
//  Function task
grunt.registerTask(taskName, description, taskFunction)
//  multi task
grunt.registerMultiTask(taskName, description, taskFunction)

registerTask

// Default task(s).
var defaultTasks = [
    'build_js:dev',
    'build_themes:dev',
    'copy:dev',
    'build_template:dev'
];
grunt.registerTask('default', defaultTasks);

registerMultiTask

grunt.registerMultiTask('cp_phpdemo','',function(){
    log( ' task ' + this.target + ' start......' );
    var config   = this.data;
    var source   = grunt.file.expand( this.data.src );
    var dest     = this.data.dest;
    if( source && source.length > 0 ){

        source.forEach( function( item ) {
            var filename = path.basename( item );
            copyfile( item, dest+filename );
        } );

    }
    log( ' task ' + this.target + ' end......' );
});

运行grunt任务

//  默认执行default任务
grunt
//  加载jsdoc全部任务配置，而且以每一个配置去执行jsdoc任务
grunt jsdoc
//  指定使用dev的任务配置，而且以这个配置去执行jsdoc任务
grunt jsdoc:dev