grunt 打包前端代碼

時間 2020-05-28

標籤 grunt 打包前端代碼欄目 Node.js 简体版

原文原文鏈接

【grunt整合版】30分鐘學會使用grunt打包前端代碼

grunt

是一套前端自動化工具，一個基於nodeJs的命令行工具，通常用於：
① 壓縮文件
② 合併文件
③ 簡單語法檢查css

對於其餘用法，我還不太清楚，咱們這裏簡單介紹下grunt的壓縮、合併文件，初學，有誤請包涵html

準備階段

一、nodeJs環境

由於grunt是基於nodeJs的，因此首先各位須要安裝nodeJS環境，這塊咱們便無論了
http://www.cnblogs.com/yexiaochai/p/3527418.html前端

二、安裝grunt

有了nodeJs環境後，咱們即可以開始搞grunt了，由於咱們可能在任何目錄下運行打包程序，因此咱們須要安裝CLI
官方推薦在全局安裝CLI（grunt的命令行接口）node

npm install -g grunt-cli

這條命令將會把grunt命令植入系統路徑，這樣就能在任意目錄運行他，緣由是jquery

每次運行grunt時，它都會使用node的require查找本地是否安裝grunt，若是找到CLI便加載這個本地grunt庫
而後應用咱們項目中的GruntFile配置，並執行任務
PS：這段先不要管，安裝完了往下看web

實例學習：打包zepto

一些東西說多了都是淚，直接先上實例吧，實例結束後再說其它的
首先在D盤新建一個項目（文件夾就好）
在裏面新增兩個文件（不要問爲何，搞進去先）express

① package.json

{  "name": "demo",  "file": "zepto",  "version": "0.1.0",  "description": "demo",  "license": "MIT",  "devDependencies": {    "grunt": "~0.4.1",    "grunt-contrib-jshint": "~0.6.3",    "grunt-contrib-uglify": "~0.2.1",    "grunt-contrib-requirejs": "~0.4.1",    "grunt-contrib-copy": "~0.4.1",    "grunt-contrib-clean": "~0.5.0",    "grunt-strip": "~0.2.1"
  },  "dependencies": {    "express": "3.x"
  }
}

② Gruntfile.js

完了咱們須要在grunt目錄下執行 npm install將相關的文件下載下來：npm

$ cd d:
$ cd grunt

而後咱們的目錄就會多一點東西：編程

多了不少東西，先別管事幹什麼的，咱們後面都會用到，這個時候在目錄下新建src文件夾，而且搞一個zepto進去json

而後在Gruntfile中新增如下代碼（先別管，增長再說）

module.exports = function (grunt) {  // 項目配置  grunt.initConfig({
    pkg: grunt.file.readJSON('package.json'),
    uglify: {
      options: {
        banner: '/*! <%= pkg.file %> <%= grunt.template.today("yyyy-mm-dd") %> */\n'
      },
      build: {
        src: 'src/<%=pkg.file %>.js',
        dest: 'dest/<%= pkg.file %>.min.js'
      }
    }
  });  // 加載提供"uglify"任務的插件
  grunt.loadNpmTasks('grunt-contrib-uglify');  // 默認任務
  grunt.registerTask('default', ['uglify']);
}

而後運行 grunt命令後

grunt

嗯嗯，多了一個文件，而且是壓縮的，不差！！！第一步結束

認識Gruntdile與package.json

不出意外，每個gurnt都會須要這兩個文件，而且極可能就只有這兩個文件（複雜的狀況有所不一樣）

package.json

這個文件用來存儲npm模塊的依賴項（好比咱們的打包如果依賴requireJS的插件，這裏就須要配置）
而後，咱們會在裏面配置一些不同的信息，好比咱們上面的file，這些數據都會放到package中
對於package的靈活配置，咱們會在後面提到

Gruntfile

這個文件尤爲關鍵，他通常幹兩件事情：
① 讀取package信息
② 插件加載、註冊任務，運行任務（grunt對外的接口所有寫在這裏面）

Gruntfile通常由四個部分組成
① 包裝函數
這個包裝函數沒什麼東西，意思就是咱們全部的代碼必須放到這個函數裏面

module.exports = function (grunt) {//你的代碼}

這個不用知道爲何，直接將代碼放入便可

② 項目/任務配置
咱們在Gruntfile通常第一個用到的就是initConfig方法配置依賴信息

pkg: grunt.file.readJSON('package.json')

這裏的 grunt.file.readJSON就會將咱們的配置文件讀出，而且轉換爲json對象

而後咱們在後面的地方就能夠採用pkg.XXX的方式訪問其中的數據了
值得注意的是這裏使用的是underscore模板引擎，因此你在這裏能夠寫不少東西

uglify是一個插件的，咱們在package依賴項進行了配置，這個時候咱們爲系統配置了一個任務
uglify（壓縮），他會幹這幾個事情：

① 在src中找到zepto進行壓縮（具體名字在package中找到）
② 找到dest目錄，沒有就新建，而後將壓縮文件搞進去
③ 在上面加幾個描述語言

這個任務配置其實就是一個方法接口調用，按照規範來就好，暫時不予關注，內幕後期來
這裏只是定義了相關參數，可是並未加載實際函數，因此後面立刻就有一句：

grunt.loadNpmTasks('grunt-contrib-uglify');

用於加載相關插件

最後註冊一個自定義任務（其實也是默認任務），因此咱們下面的命令行是等效的：

grunt == grunt uglify

至此，咱們就簡單解析了一番grunt的整個操做，下面來合併文件的例子

合併文件

合併文件依賴於grunt-contrib-concat插件，因此咱們的package依賴項要新增一項

"devDependencies": {  "grunt": "~0.4.1",  "grunt-contrib-jshint": "~0.6.3",  "grunt-contrib-concat": "~0.3.0",  "grunt-contrib-uglify": "~0.2.1",  "grunt-contrib-requirejs": "~0.4.1",  "grunt-contrib-copy": "~0.4.1",  "grunt-contrib-clean": "~0.5.0",  "grunt-strip": "~0.2.1"},

而後再將代碼寫成這個樣子

module.exports = function (grunt) {  // 項目配置  grunt.initConfig({
    pkg: grunt.file.readJSON('package.json'),
    concat: {
      options: {
        separator: ';'
      },
      dist: {
        src: ['src/zepto.js', 'src/underscore.js', 'src/backbone.js'],
        dest: 'dest/libs.js'
      }
    }
  });
  grunt.loadNpmTasks('grunt-contrib-concat');  // 默認任務
  grunt.registerTask('default', ['concat']);
}

運行後，神奇的一幕發生了：

三個文件被壓縮成了一個，可是沒有壓縮，因此，咱們這裏再加一步操做，將之壓縮後再合併

module.exports = function (grunt) {  // 項目配置  grunt.initConfig({
    pkg: grunt.file.readJSON('package.json'),
    concat: {
      options: {
        separator: ';'
      },
      dist: {
        src: ['src/zepto.js', 'src/underscore.js', 'src/backbone.js'],
        dest: 'dest/libs.js'
      }
    },
    uglify: {
      build: {
        src: 'dest/libs.js',
        dest: 'dest/libs.min.js'
      }
    }
  });
  grunt.loadNpmTasks('grunt-contrib-uglify');
  grunt.loadNpmTasks('grunt-contrib-concat');  // 默認任務
  grunt.registerTask('default', ['concat', 'uglify']);
}

我這裏的作法是先合併造成一個libs，而後再將libs壓縮成libs.min.js

因此咱們這裏換個作法，先壓縮再合併，其實unglify已經幹了這些事情了

module.exports = function (grunt) {  // 項目配置  grunt.initConfig({
    pkg: grunt.file.readJSON('package.json'),
    uglify: {      "my_target": {        "files": {          'dest/libs.min.js': ['src/zepto.js', 'src/underscore.js', 'src/backbone.js']
        }
      }
    }
  });
  grunt.loadNpmTasks('grunt-contrib-uglify');  // 默認任務
  grunt.registerTask('default', ['uglify']);
}

因此，咱們就暫時不去關注concat了

最後，今天時間不早了，咱們最後研究下grunt配合require因而便結束今天的學習吧

合併requireJS管理的文件

有了前面基礎後，咱們來幹一件平時很頭疼的事情，即是將require管理的全部js文件給壓縮了合併爲一個文件
首先咱們創建一個簡單的程序，裏面使用了zepto、backbone、underscore（事實上我並未使用什麼）

在main.js中新增代碼：

require.config({
 baseUrl: '',
 shim: {
  $: {
      exports: 'zepto'
  },
  _: {
   exports: '_'
  },
  B: {
   deps: [    '_',    '$'
     ],
   exports: 'Backbone'
  }
 },
 paths: {  '$': 'src/zepto',  '_': 'src/underscore',  'B': 'src/backbone'
 }
});
requirejs(['B'], function (b) {
});

這樣的話運行會自動加載幾個文件，咱們如今但願將之合併爲一個libs.js該怎麼幹呢？？？

咱們這裏使用自定義任務方法來作，由於咱們好像沒有介紹他

要使用requireJS相關須要插件

grunt.loadNpmTasks('grunt-contrib-requirejs');

由於咱們之後可能存在配置文件存在各個項目文件的狀況，因此咱們這裏將requireJs相關的配置放入gruntCfg.json中

這樣咱們的package.json就沒有什麼實際意義了：

{  "name": "demo",  "version": "0.1.0",  "description": "demo",  "license": "MIT",  "devDependencies": { "grunt": "~0.4.1", "grunt-contrib-jshint": "~0.6.3", "grunt-contrib-concat": "~0.3.0", "grunt-contrib-uglify": "~0.2.1", "grunt-contrib-requirejs": "~0.4.1", "grunt-contrib-copy": "~0.4.1", "grunt-contrib-clean": "~0.5.0", "grunt-strip": "~0.2.1"
 
  },  "dependencies": {    "express": "3.x"
  }
}

咱們這裏設置的require相關的grunt配置文件以下（gruntCfg.json）：

{  "requirejs": {    "main": {      "options": {        "baseUrl": "",        "paths": {          "$": "src/zepto",          "_": "src/underscore",          "B": "src/backbone",          "Test": "src/Test"
        },        "web": {          "include": [            "$",            "_",            "B",            "Test"
          ],          "out": "dest/libs.js"
        }
      }
    }
  }
}

這裏咱們要打包這些文件搞到dest的libs.js文件中，這個文件照作就行，最後核心代碼以下：

module.exports = function (grunt) {
  grunt.loadNpmTasks('grunt-contrib-requirejs');  //爲了介紹自定義任務搞了一個這個
  grunt.registerTask('build', 'require demo', function () {    //任務列表
    var tasks = ['requirejs'];    //源碼文件
    var srcDir = 'src';    //目標文件
    var destDir = 'dest';    //設置參數
    grunt.config.set('config', {
      srcDir: srcDir,
      destDir: destDir
    });    //設置requireJs的信息
    var taskCfg = grunt.file.readJSON('gruntCfg.json');    var options = taskCfg.requirejs.main.options,
        platformCfg = options.web,
        includes = platformCfg.include,
        paths = options.paths;    var pos = -1;    var requireTask = taskCfg.requirejs;
    options.path = paths;
    options.out = platformCfg.out;
    options.include = includes;    //運行任務    grunt.task.run(tasks);
    grunt.config.set("requirejs", requireTask);
  });
}

搞完了運行就好：grunt build

grunt build

最後發現葉小釵三字，我就放心了，安全！！！！！！

配置任務/grunt.initConfig

前面咱們簡單的介紹了grunt相關的知識，這裏咱們這裏還須要再熟悉下Gruntfile相關的知識點，好比說配置任務

grunt的任務配置都是在Gruntfile中的grunt.initConfig方法中指定的，這個配置主要都是一些命名性屬性
好比咱們上次用到的合併以及壓縮的任務配置：

grunt.initConfig({
    concat: {        //這裏是concat任務的配置信息    },
    uglify: {        //這裏是uglify任務的配置信息    },    //任意非任務特定屬性
    my_property: 'whatever',
    my_src_file: ['foo/*.js', 'bar/*.js']
});

其中的my_property徹底可能讀取外部json配置文件，而後在上面任務配置中即可以，好比咱們要壓縮的文件爲準或者最後要放到哪裏，即可以在此配置

咱們使用grunt的時候，主要工做就是配置任務或者建立任務，實際上就是作一個事件註冊，而後由咱們觸發之，因此grunt的核心仍是事件註冊
每次運行grunt時，咱們能夠指定運行一個或者多個任務，經過任務決定要作什麼，好比咱們同時要壓縮和合並還要作代碼檢查

grunt.registerTask('default', ['jshint','qunit','concat','uglify']);

當運行一個基本任務時，grunt並不會查找配置和檢查運行環境，他僅僅運行指定的任務函數，能夠傳遞冒號分割參數，好比：

grunt.registerTask('foo', 'A sample task that logs stuff.', function (arg1, arg2) {  if (arguments.length === 0) {
    grunt.log.writeln(this.name + ", no args");
  } else {
    grunt.log.writeln(this.name + ", " + arg1 + " " + arg2);
  }
});

運行結果以下：

$ grunt foo:testing:123Running "foo:testing:123" (foo) task
foo, testing 123$ grunt foo:testing
Running "foo:testing" (foo) task
foo, testing undefined

$ grunt foo
Running "foo" task
foo, no args

這裏有個多任務的狀況，就是一個任務裏面實際上第一了多個東東，這個時候就有所不一樣

grunt.initConfig({
    log: {
        demo01: [1,2,3],
        demo02: 'hello world',
        demo03: false
    }
});
grunt.registerTask('log','log stuff.', function(){
    grunt.log.writeln(this.target + ': ' + this.data);
});

若是咱們運行，運行狀況以下：

???????

更多時候，咱們實際場景中都會須要自定義任務，而在咱們任務內部使用 grunt.task.run({}) 運行任務
這塊的知識點，咱們後面以實際例子說明

grunt插件

學習grunt主要就是學習grunt的插件使用，因此咱們今天先來學習經常使用的幾個插件

grunt-contrib-unglify

咱們仍然以簡單例子學習

module.exports = function (grunt) {
  grunt.initConfig({
    uglify: {
      my_target: {
        files: {          'dest/libs.min.js': ['src/zepto.js', 'src/underscoce.js']
        }
      }
    }
  });
  grunt.loadNpmTasks('grunt-contrib-uglify');
}

這樣會將src裏面的zepto等文件打包值dest的lib.min.js中

壓縮一個文件夾的全部文件

而後這段代碼很是有意思，他會將一個文件目錄裏面的全部js文件打包到另外一個文件夾

module.exports = function (grunt) {
  grunt.initConfig({
    uglify: {
      my_target: {
        files: [{
          expand: true,
          cwd: 'src',
          src: '**/*.js',
          dest: 'dest'
        }]
      }
    }
  });
  grunt.loadNpmTasks('grunt-contrib-uglify');
}

如果你但願給你文件的頭部加一段註釋性語言配置banner信息便可

grunt.initConfig({
  pkg: grunt.file.readJSON('package.json'),
  uglify: {
    options: {
      banner: '/*! 註釋信息 */'
    },
    my_target: {
      files: {        'dest/output.min.js': ['src/input.js']
      }
    }
  }
});

grunt-contrib-concat

該插件主要用於代碼合併，將多個文件合併爲一個，咱們前面的uglify也提供了必定合併的功能
在可選屬性中咱們能夠設置如下屬性：
① separator 用於分割各個文件的文字，
② banner 前面說到的文件頭註釋信息，只會出現一次
③ footer 文件尾信息，只會出現一次
④ stripBanners去掉源代碼註釋信息（只會清楚/**/這種註釋）

一個簡單的例子：

module.exports = function (grunt) {
  grunt.initConfig({
  concat: {
    options: {
      separator: '/*分割*/',
      banner: '/*測試*/',
      footer: '/*footer*/'
     
    },
    dist: {
      src: ['src/zepto.js', 'src/underscore.js', 'src/backbone.js'],
      dest: 'dist/built.js',
    }
  }
});
  grunt.loadNpmTasks('grunt-contrib-concat');
}

合併三個文件爲一個，這種在咱們源碼調試時候頗有意義

構建兩個文件夾

有時候咱們可能須要將合併的代碼放到不一樣的文件，這個時候能夠這樣幹

module.exports = function (grunt) {
  grunt.initConfig({
    concat: {
      basic: {
        src: ['src/zepto.js'],
        dest: 'dest/basic.js'
      },
      extras: {
        src: ['src/underscore.js', 'src/backbone.js'],
        dest: 'dest/with_extras.js'
      }
    }
  });
  grunt.loadNpmTasks('grunt-contrib-concat');
}

這種功能還有這樣的寫法：

module.exports = function (grunt) {
  grunt.initConfig({
    concat: {
      basic_and_extras: {
        files: {          'dist/basic.js': ['src/test.js', 'src/zepto.js'],          'dist/with_extras.js': ['src/underscore.js', 'src/backbone.js']
        }
      }
    }
  });
  grunt.loadNpmTasks('grunt-contrib-concat');
}

第二種寫法便於使用配置文件，具體各位選取吧，至於讀取配置文件的東西咱們這裏就先不關注了

grunt-contrib-jshint

該插件用於檢測文件中的js語法問題，好比我test.js是這樣寫的：

alert('我是葉小釵')

module.exports = function (grunt) {
  grunt.initConfig({
    jshint: { 
      all: ['src/test.js']
    }
  });
  grunt.loadNpmTasks('grunt-contrib-jshint');
}

運行結果是：

$ grunt jshint
Running "jshint:all" (jshint) task
Linting src/test.js ...ERROR[L1:C15] W033: Missing semicolon.
alert('我是葉小釵')

說我缺乏一個分號，好像確實缺乏.....若是在裏面寫明顯的BUG的話會報錯
多數時候，咱們認爲沒有分號無傷大雅，因此，咱們文件會忽略這個錯誤：

jshint: {
  options: {    '-W033': true
  },
  all: ['src/test.js']
}

這裏有一個稍微複雜的應用，就是咱們合併以前作一次檢查，合併以後再作一次檢查，咱們能夠這樣寫

module.exports = function (grunt) {
  grunt.initConfig({
    concat: {
      dist: {
        src: ['src/test01.js', 'src/test02.js'],
        dest: 'dist/output.js'
      }
    },
    jshint: {
      options: {        '-W033': true 
      },
      pre: ['src/test01.js', 'src/test02.js'],
      after: ['dist/output.js']
    }
  });
  grunt.loadNpmTasks('grunt-contrib-concat');
  grunt.loadNpmTasks('grunt-contrib-jshint');
}

$ grunt jshint:pre concat jshint:after
Running "jshint:pre" (jshint) task>> 2 files lint free.
Running "concat:dist" (concat) task
File "dist/output.js" created.
Running "jshint:after" (jshint) task>> 1 file lint free.

這裏連續運行了三個任務，先作檢查再合併，而後作檢測，我這裏寫了兩個簡單的文件，若是將jquery搞進去的話，好像還出了很多BUG......
因此真的要用它還要自定一些規範，咱們這裏暫時到這裏，先進入下一個插件學習

grunt-contrib-requirejs

咱們的grunt打包程序極有可能與requirejs一塊兒使用，可是幾個插件學習下來又屬requireJs的使用最爲麻煩，由於網上資源不多，搞到這一段耗掉了我不少精力

這個時候你就會感嘆，英語好不必定編程好，英語差想成爲高手仍是不簡單啊！！！

requirejs: {
  compile: {
    options: {
      baseUrl: "path/to/base",
      mainConfigFile: "path/to/config.js",
      name: "path/to/almond", // assumes a production build using almond
      out: "path/to/optimized.js"
    }
  }
}

官方的例子首先就是這幾個屬性：

baseUrl 表明全部的js文件都會相對於這個目錄

mainConfigFile 配置文件目錄

name ？？？

out 輸出文件

一些參數咱們不太瞭解，這個時候就只能以例子破之了

module.exports = function (grunt) {
  grunt.initConfig({
    requirejs: {
      compile: {        "options": {          "baseUrl": "./",          "paths": {            "$": "src/zepto",            "_": "src/underscore",            "B": "src/backbone",            "Test": "src/Test01"
          },          "include": [            "$",            "_",            "B",            "Test"
          ],          "out": "dest/libs.js"
        }
      }
    }
  });
  grunt.loadNpmTasks('grunt-contrib-requirejs');
}

這樣配置後，會將include裏面的文件打包爲out對應的文件，paths的自己意義不大，就是用於配置include裏面的指向

這個時候咱們來加個name看看有神馬做用：

module.exports = function (grunt) {
  grunt.initConfig({
    requirejs: {
      compile: {        "options": {          "baseUrl": "./",          "name": 'src/test02.js',          "paths": {            "$": "src/zepto",            "_": "src/underscore",            "B": "src/backbone",            "Test": "src/Test01"
          },          "include": [            "$",            "_",            "B",            "Test"
          ],          "out": "dest/libs.js"
        }
      }
    }
  });
  grunt.loadNpmTasks('grunt-contrib-requirejs');
}

這樣的話，會將name對應文件壓縮到壓縮文件的最前面，可是具體是幹什麼的，仍是不太清楚，其英文註釋說是單個文件或者其依賴項優化，不知道優化什麼啊。。。囧！！！

requireJS基本的用法就是這樣了，其詳細信息，咱們過段時間再來看看，下面說一下requireJS的其它用法

咱們這裏將requireJS的配置信息放在外面，而Gruntfile採用自定義任務的方式完成上面的功能

配置文件/cfg.json

{requirejs: {  "options": {    "baseUrl": "./",    "paths": {      "$": "src/zepto",      "_": "src/underscore",      "B": "src/backbone",      "Test": "src/Test01"
    },    "include": [      "$",      "_",      "B",      "Test"
    ],    "out": "dest/libs.js"
  }
}}

而後，這裏咱們便不是有initConfig的作法了，直接使用自定義任務

module.exports = function (grunt) {

  grunt.loadNpmTasks('grunt-contrib-requirejs');

  grunt.registerTask('build', 'require demo', function () {    //第一步，讀取配置信息
    var cfg = grunt.file.readJSON('cfg.json');
    cfg = cfg.requirejs;
    grunt.config.set('requirejs', { test: cfg });    //第二步，設置參數
    grunt.log.debug('參數：' + JSON.stringify(grunt.config()));    //第三步跑任務
    grunt.task.run(['requirejs']);
    
  });

}

$ grunt build --debug
Running "build" task
[D] Task source: d:\grunt\Gruntfile.js
[D] 參數：{"requirejs":{"test":{"options":{"baseUrl":"./","paths":{"$":"src/zept
o","_":"src/underscore","B":"src/backbone","Test":"src/Test01"},"include":["$","_","B","Test"],"out":"dest/libs.js"}}}}

Running "requirejs:test" (requirejs) task
[D] Task source: d:\grunt\node_modules\grunt-contrib-requirejs\tasks\requirejs.j
s>> Tracing dependencies for: d:/grunt/dest/libs.js
>> Uglifying file: d:/grunt/dest/libs.js
>> d:/grunt/dest/libs.js
>> ----------------
>> d:/grunt/src/zepto.js
>> d:/grunt/src/underscore.js
>> d:/grunt/src/backbone.js
>> d:/grunt/src/Test01.js

效果仍是有的，最後咱們介紹下requireJS打包模板文件

require與模板文件

咱們知道，模板文件通常都是html，好比咱們這裏的demo01.html，對於這個文件咱們應該怎麼打包呢？其實很簡單......

須要幹兩件事情：

① 引入require.text

② 加入模板文件

{  "requirejs": {    "options": {      "baseUrl": "./",      "paths": {        "$": "src/zepto",        "_": "src/underscore",        "B": "src/backbone",        "test": "src/test01",        "text": "src/require.text"

      },      "include": [        "$",        "_",        "B",        "test",        "text!src/demo01.html"
      ],      "out": "dest/libs.js"
    }
  }
}

因而，咱們便成功將模板打入了

$ grunt build --debug
Running "build" task
[D] Task source: d:\grunt\Gruntfile.js
[D] 參數：{"requirejs":{"test":{"options":{"baseUrl":"./","paths":{"$":"src/zept
o","_":"src/underscore","B":"src/backbone","test":"src/test01","text":"src/requi
re.text"},"include":["$","_","B","test","text!src/demo01.html"],"out":"dest/libs
.js"}}}}

Running "requirejs:test" (requirejs) task
[D] Task source: d:\grunt\node_modules\grunt-contrib-requirejs\tasks\requirejs.j
s>> Tracing dependencies for: d:/grunt/dest/libs.js
>> Uglifying file: d:/grunt/dest/libs.js
>> d:/grunt/dest/libs.js
>> ----------------
>> d:/grunt/src/zepto.js
>> d:/grunt/src/underscore.js
>> d:/grunt/src/backbone.js
>> d:/grunt/src/test01.js
>> d:/grunt/src/require.text.js
>> text!src/demo01.html

在文件中咱們引用方式是：

"text!src/demo01.html" => '具體文件'

過濾關鍵字

module.exports = function (grunt) {

grunt.initConfig({

requirejs: {

compile: {

"options": {

optimize: 'uglify2',

uglify2: {

mangle: {

except: ["$super"]

}

"baseUrl": "./",

"paths": {

"UIAbstractView": "ui_beta/ui.abstract.view",

"UILayer": "ui_beta/ui.layer"

"include": [

"UIAbstractView"

"out": "dest/libs.js"

}

});

grunt.loadNpmTasks('grunt-contrib-requirejs');

grunt.registerTask('default', ['requirejs']);

打包樣式文件

樣式文件的打包方式與js不太同樣，這裏咱們下載css-min插件，而且在package.json中新增依賴項

{  "name": "demo",  "version":         "0.1.0",  "description":     "demo",  "license":         "MIT",  "devDependencies": {    "grunt":                   "~0.4.1",    "grunt-contrib-jshint":    "~0.6.3",    "grunt-contrib-concat":    "~0.3.0",    "grunt-contrib-uglify":    "~0.2.1",    "grunt-contrib-requirejs": "~0.4.1",    "grunt-contrib-copy":      "~0.4.1",    "grunt-contrib-clean":     "~0.5.0",    "grunt-strip":             "~0.2.1",    "grunt-contrib-watch": "~0.6.0",    "grunt-contrib-cssmin": "~0.5.0"
  },  "dependencies":    {    "express": "3.x"
  }
}

module.exports = function (grunt) {
  grunt.initConfig({
    cssmin: {
      compress: {
        files: {          'dest/car.min.css': [          "src/car.css",          "src/car01.css"
        ]
        }
      }
    }
  });

  grunt.loadNpmTasks('grunt-contrib-cssmin');

}

如此一來咱們即可以壓縮合並CSS文件了：

$ grunt cssmin --debug
Running "cssmin:compress" (cssmin) task
[D] Task source: d:\grunt\node_modules\grunt-contrib-cssmin\tasks\cssmin.js
File dest/car.min.css created.

移動打包文件

其實，grunt自己具備這樣的功能，可是咱們實際項目重會出現這種可能：

咱們核心框架會有一套壓縮代碼，而且會在對應目錄生成文件用於發佈，可是這個地方的權限對各個頻道團隊是不可見的

因此，咱們在各個頻道的公共文件夾內應該將剛剛的文件給複製過去，這塊代碼其實很簡單，不須要任何新知識都能實現：

咱們這裏依舊採用昨天的require相關的代碼，可是一有個不一樣的地方就是，咱們要同時在D盤的common文件夾中生成該文件

這個代碼其實比較簡單，這裏咱們先介紹一個新的插件copy

grunt-contrib-copy

該插件用於複製文件到你想要的文件夾處

grunt.initConfig({ copy: {
  main: {
    flatten: true,
    src: 'src/*.js',
    dest: 'dest/'
  }
}
});

這段代碼就會將src中的js文件搞到dest裏面，而且新建src文件夾：

$ grunt copy
Running "copy:main" (copy) task
Copied 7 files

如果不想複製文件夾只要文件應該這樣幹：

grunt.initConfig({ copy: {
  main: {
    flatten: true,    //    filter: 'isFile',
    expand: true,
    src: 'src/**.js',
    dest: 'dest/'
  }
}
});

這塊完了，咱們就來移動打包文件至D盤了

移動打包文件

這個時候代碼這樣寫就好（也許移動前咱們還想將其文件夾裏面的東西銷燬，暫時不考慮了）

module.exports = function (grunt) {

  grunt.initConfig({ copy: {
    main: {      //      flatten: true,
      //      expand: true,
      src: 'dest/**.js',
      dest: 'd:/common/'
    }
  }
  });

  grunt.loadNpmTasks('grunt-contrib-copy');
  grunt.loadNpmTasks('grunt-contrib-requirejs');

  grunt.registerTask('build', 'require demo', function () {    //第一步，讀取配置信息
    var cfg = grunt.file.readJSON('cfg.json');
    cfg = cfg.requirejs;
    grunt.config.set('requirejs', { test: cfg });    //第二步，設置參數
    grunt.log.debug('參數：' + JSON.stringify(grunt.config()));    //第三步跑任務
    grunt.task.run(['requirejs']);

  });

  grunt.registerTask('default', 'test demo', ['build', 'copy']);

}

Running "build" task

Running "requirejs:test" (requirejs) task>> Tracing dependencies for: d:/grunt/dest/libs.js
>> Uglifying file: d:/grunt/dest/libs.js
>> d:/grunt/dest/libs.js
>> ----------------
>> d:/grunt/src/zepto.js
>> d:/grunt/src/underscore.js
>> d:/grunt/src/backbone.js
>> d:/grunt/src/test01.js
>> d:/grunt/src/require.text.js
>> text!src/demo01.htmlRunning "copy:main" (copy) task
Copied 8 files

關於移動相關的知識點暫時介紹到這裏，咱們進入下一話題

分支/頻道處理

咱們在實際項目重會遇到這種狀況，咱們一個主幹分支上可能拉出不少分支完成不一樣的功能，而各個分支就有那麼一點點不一樣，那麼這個時候打包工具該怎麼辦呢？

咱們通常是這樣處理的：

① 首先全局只會有一個打包工具

② 其次每個分支都會有一個gruntCfg.json的配置文件，存儲相關的打包信息

③ 每次打包時候便把響應的分支打印到各自的dest目錄裏面

爲了模擬這一狀況咱們將grunt打包相關的文件放到D盤的grunt目錄裏面，並在D盤新建gruntDemo目錄

而後咱們在gruntDemo中創建一個項目，而且爲這個項目拉一個分支，好比如今項目是地demo01與demo02

如今文件結構以下：

D:\GRUNTDEMO
├─demo01
│  │  gruntCfg.json
│  │
│  └─src
│          backbone.js
│          require.js
│          require.text.js
│          test01.js
│          test02.js
│          underscore.js
│          zepto.js
│
└─demo02
    │  gruntCfg.json
    │
    └─src
            backbone.js
            require.js
            require.text.js
            test01.js
            test02.js
            underscore.js
            zepto.js

這個時候，要實現功能最好的方法就是寫自定義任務了，其它方案很差使，這個時候起配置文件也須要有必定修改，好比其中的路徑須要加入參數信息

{  "requirejs": {    "options": {      "baseUrl": "<%= config.srcDir %>",      "paths": {        "$": "src/zepto",        "_": "src/underscore",        "B": "src/backbone",        "test": "src/test01",        "text": "src/require.text"

      },      "include": [        "$",        "_",        "B",        "test",        "text!src/demo01.html"
        ],        "out": "<%= config.destDir %>/libs.js"
      }
  }
}

這個時候initConfig相關信息時候，首先得傳入path依賴的文件目錄，以及輸出的文件目錄

module.exports = function (grunt) {

  grunt.loadNpmTasks('grunt-contrib-requirejs');  //channel爲頻道名稱，project爲項目名稱，這裏對應gruntDemo，branch爲其分支，默認與grunt目錄爲平行關係，佛則package.json裏面應該有配置信息
  grunt.registerTask('build', 'require demo', function (channel, project, branch) {    var path = '../' + channel + '/' + project + branch;
    grunt.log.debug('path: ' + path);    //第一步，讀取配置信息
    var cfg = grunt.file.readJSON(path + '/gruntCfg.json');
    cfg = cfg.requirejs;

    grunt.config.set('config', {
      srcDir: path,
      destDir: path + '/dest'
    });

    grunt.config.set('requirejs', { main: cfg });    //第二步，設置參數
    grunt.log.debug('param: ' + JSON.stringify(grunt.config()));    //第三步跑任務
    grunt.task.run(['requirejs']);

  });

  grunt.registerTask('default', 'test demo', ['build', 'copy']);

}

因而咱們第一步工做成功了：

$ grunt build:gruntDemo:demo:02 --debug
Running "build:gruntDemo:demo:02" (build) task
[D] Task source: d:\grunt\Gruntfile.js
[D] path: ../gruntDemo/demo02
[D] param: {"config":{"srcDir":"../gruntDemo/demo02","destDir":"../gruntDemo/dem
o02/dest"},"requirejs":{"main":{"options":{"baseUrl":"../gruntDemo/demo02","path
s":{"$":"src/zepto","_":"src/underscore","B":"src/backbone","test":"src/test01","text":"src/require.text"},"include":["$","_","B","test","text!src/demo01.html"]
,"out":"../gruntDemo/demo02/dest/libs.js"}}}}

Running "requirejs:main" (requirejs) task
[D] Task source: d:\grunt\node_modules\grunt-contrib-requirejs\tasks\requirejs.j
s>> Tracing dependencies for: d:/gruntDemo/demo02/dest/libs.js>> Uglifying file: d:/gruntDemo/demo02/dest/libs.js>> d:/gruntDemo/demo02/dest/libs.js>> ----------------
>> d:/gruntDemo/demo02/src/zepto.js>> d:/gruntDemo/demo02/src/underscore.js>> d:/gruntDemo/demo02/src/backbone.js>> d:/gruntDemo/demo02/src/test01.js>> d:/gruntDemo/demo02/src/require.text.js>> text!src/demo01.html

若是改變一下任務命令呢：

grunt build:gruntDemo:demo:01 --debug

結果證實也是沒有問題的，這個地方我就不貼出來了，各位本身去試試，咱們分支處理一塊暫時到這裏

頻道處理其實咱們這裏已經作了，第一個參數是頻道，第二個參數是項目，第三個參數爲分支，因此頻道相關咱們暫時就不說了

native與HTML5打包

最後讓咱們來看看如何打包native文件，native文件的打包其實與打包HTML5的方式相似，只不過咱們這裏須要一點點配置，讓一個項目能夠打包成不一樣的效果

仍然以上面demo01爲例，他的配置文件可能就須要作必定調整：

{    "requirejs": {        "options": {            "baseUrl": "<%= config.srcDir %>", 
            "paths": {                "$": "src/zepto", 
                "_": "src/underscore", 
                "B": "src/backbone", 
                "test": "src/test01", 
                "text": "src/require.text"
            }, 
            "web": {                "include": [                    "$", 
                    "_", 
                    "B", 
                    "test"
                ], 
                "out": "<%= config.destDir %>/libs.js"
            }, 
            "app": {                "include": [                    "$", 
                    "_", 
                    "B", 
                    "test", 
                    "text!src/demo01.html"
                ], 
                "out": "<%= config.destDir %>/libs_app.js"
            }
        }
    }
}

這裏爲了表現一點web與native的不一樣，我特地將web中少包含一個text文件，具體還得各位項目中去實踐

如此一來，咱們的代碼須要作些許調整：

module.exports = function (grunt) {

  grunt.loadNpmTasks('grunt-contrib-requirejs');  //type 打包app包仍是web包，channel爲頻道名稱，project爲項目名稱，這裏對應gruntDemo，branch爲其分支，默認與grunt目錄爲平行關係，佛則package.json裏面應該有配置信息
  grunt.registerTask('build', 'require demo', function (type, channel, project, branch) {    var path = '../' + channel + '/' + project + branch;
    grunt.log.debug('path: ' + path);    //第一步，讀取配置信息
    var cfg = grunt.file.readJSON(path + '/gruntCfg.json');
    cfg = cfg.requirejs.options;

    grunt.config.set('config', {
      srcDir: path,
      destDir: path + '/dest'
    });

    grunt.log.debug('param: ' + JSON.stringify(cfg));
    grunt.log.debug('param: ' + cfg[type]['include']);    var taskCfg = {};
    taskCfg.options = {};
    taskCfg.options.baseUrl = cfg.baseUrl;
    taskCfg.options.paths = cfg.paths;
    taskCfg.options['include'] = cfg[type]['include'];
    taskCfg.options.out = cfg[type].out;


    grunt.config.set('requirejs', { main: taskCfg });    //第二步，設置參數
    grunt.log.debug('param: ' + JSON.stringify(grunt.config()));    //第三步跑任務
    grunt.task.run(['requirejs']);

  });

  grunt.registerTask('default', 'test demo', ['build', 'copy']);

}

因而即可以運行了！！！

$ grunt build:app:gruntDemo:demo:01 --debug
Running "build:app:gruntDemo:demo:01" (build) task
[D] Task source: d:\grunt\Gruntfile.js
[D] path: ../gruntDemo/demo01
[D] param: {"baseUrl":"<%= config.srcDir %>","paths":{"$":"src/zepto","_":"src/u
nderscore","B":"src/backbone","test":"src/test01","text":"src/require.text"},"we
b":{"include":["$","_","B","test"],"out":"<%= config.destDir %>/libs.js"},"app":
{"include":["$","_","B","test","text!src/demo01.html"],"out":"<%= config.destDir
 %>/libs_app.js"}}
[D] param: $,_,B,test,text!src/demo01.html
[D] param: {"config":{"srcDir":"../gruntDemo/demo01","destDir":"../gruntDemo/dem
o01/dest"},"requirejs":{"main":{"options":{"baseUrl":"../gruntDemo/demo01","path
s":{"$":"src/zepto","_":"src/underscore","B":"src/backbone","test":"src/test01","text":"src/require.text"},"include":["$","_","B","test","text!src/demo01.html"]
,"out":"../gruntDemo/demo01/dest/libs_app.js"}}}}

Running "requirejs:main" (requirejs) task
[D] Task source: d:\grunt\node_modules\grunt-contrib-requirejs\tasks\requirejs.j
s>> Tracing dependencies for: d:/gruntDemo/demo01/dest/libs_app.js>> Uglifying file: d:/gruntDemo/demo01/dest/libs_app.js>> d:/gruntDemo/demo01/dest/libs_app.js>> ----------------
>> d:/gruntDemo/demo01/src/zepto.js>> d:/gruntDemo/demo01/src/underscore.js>> d:/gruntDemo/demo01/src/backbone.js>> d:/gruntDemo/demo01/src/test01.js>> d:/gruntDemo/demo01/src/require.text.js>> text!src/demo01.html