摘要:
gulp与grunt一样,都是自动构建工具。和grunt相比它更突出一个流的概念,任务是一个接一个执行的。今天就分享如何用gulp做自动化。
安装:
gulp也是基于node环境,所以安装gulp之前你需要安装node.js。
npm install -g gulp
只要在命令窗口中执行上面一行命令就完成安装,这样安装的是全局安装。在项目中一般是通过package.json中的devDependencies属性来安装。如下:
{ "name": "", "version": "0.0.0", "description": "", "main": "gulpfile.js", "dependencies": {}, "devDependencies": { "gulp": "~3.5.6" }, "license": "ISC" }
执行npm install就会将gulp安装到当前项目中。
如何运行:
安装完gulp之后,需要新建一个gulpfile.js文件,一般是在项目的根目录,与package.json放在一块。那gulpfile.js文件里面到底写什么呢?当然是定义一些任务。如下:
var gulp = require('gulp'); gulp.task('default', function() { // 执行任务 });
然后在当前目录中通过命令窗口执行gulp,default里面的任务就会被执行。
配置参数:
gulp.src(globs[, options])
加载文件,并将文件以流的方式传到插件中,如下:
gulp.src('client/templates/*.jade') .pipe(jade()) .pipe(minify()) .pipe(gulp.dest('build/minified_templates'));
gulp首先会加载client/templates/下的所有jade文件,然后分别传递给jade插件、minify插件,然后输出到build/minified_templates中。
globs
类型:String,Array
文件或者是路径,多个文件以数组的形式。
options
类型:Object
gulp通过options将配置参数传递给node
options.buffer
类型:bool
默认值: false
是否将文件以流的方式返回,false设置文件内容以流的方式读取,并且不缓存,对于大文件设置缓存将是非常有用的。
options.read
类型:bool
默认值:true
设置是否读取文件,如果设置false将永远不读取文件
options.base
类型: String
设置输出文件的根目录,如下:
gulp.src('client/js/**/*.js') // Matches 'client/js/somedir/somefile.js' and resolves `base` to `client/js/` .pipe(minify()) .pipe(gulp.dest('build')); // Writes 'build/somedir/somefile.js' gulp.src('client/js/**/*.js', { .pipe(gulp.dest('build')); // Writes 'build/js/somedir/somefile.jbase: 'client' }) .pipe(minify())s'
gulp.dest(path[, options])
输出文件,可以输出到不同目录下,如果目录不存在就创建,如下:
gulp.src('./client/templates/*.jade') .pipe(jade()) .pipe(gulp.dest('./build/templates')) .pipe(minify()) .pipe(gulp.dest('./build/minified_templates'));
path
类型: String,Function
设置输出文件的路径
options.cwd
类型: String
默认值: process.cwd()
输出的文件夹,只有当路径为相对路径时才起作用
options.mode
类型:String
默认值:0777
设置输出文件的权限
gulp.task(name[, deps], fn)
定义一个任务,如下:
gulp.task('somename', function() { // Do stuff });
name
任务名,调用任务是只需要gulp.run(任务名)
deps
类型:Array
执行当前任务所需要依赖的任务,被依赖的任务会在当前任务执行之前执行。注意异步任务
fn
需要执行的任务都定义在此处
异步执行任务:
使用回调函数
// run a command in a shell var exec = require('child_process').exec; gulp.task('jekyll', function(cb) { // build Jekyll exec('jekyll build', function(err) { if (err) return cb(err); // return error cb(); // finished task }); });
返回一个文件流 gulp.task('somename', function() { var stream = gulp.src('client/**/*.js') .pipe(minify()) .pipe(gulp.dest('build')); return stream; });
使用promise
var Q = require('q'); gulp.task('somename', function() { var deferred = Q.defer(); // do async stuff setTimeout(function() { deferred.resolve(); }, 1); return deferred.promise; });
注意任务依赖关系,下面是一个例子:
var gulp = require('gulp'); // takes in a callback so the engine knows when it'll be done gulp.task('one', function(cb) { // do stuff -- async or otherwise cb(err); // if err is not null and not undefined, the run will stop, and note that it failed }); // identifies a dependent task must be complete before this one begins gulp.task('two', ['one'], function() { // task 'one' is done now }); gulp.task('default', ['one', 'two']);
gulp.watch(glob [, opts], tasks) or gulp.watch(glob [, opts, cb])
监听文件,当文件发生变化时,定义的任务将会被执行。如下当js文件发生改变时会触发change事件。
var watcher = gulp.watch('js/**/*.js', ['uglify','reload']); watcher.on('change', function(event) { console.log('File ' + event.path + ' was ' + event.type + ', running tasks...'); }); 或者: gulp.watch('js/**/*.js', function(event) { console.log('File ' + event.path + ' was ' + event.type + ', running tasks...'); });
实例:
下面是一个简单的例子,实现js、css的压缩合并。
package.json安装模块
{ "name": "", "version": "0.0.0", "description": "", "main": "gulpfile.js", "dependencies": {}, "devDependencies": { "gulp": "~3.5.6", "gulp-minify-css": "~0.3.0", "gulp-uglify": "^1.0.0", "gulp-concat": "~2.0.0", "gulp-rename": "^1.0.0" }, "license": "ISC" }
gulpfile.js
var gulp = require('gulp'); // 加载模块 var minifycss = require('gulp-minify-css'), // CSS压缩 uglify = require('gulp-uglify'), // js压缩 concat = require('gulp-concat'), // 合并文件 rename = require('gulp-rename'); // 重命名 // 合并、压缩、重命名css gulp.task('min-styles', function() { gulp.src(['./static/css/*.css']) .pipe(concat('all.css')) .pipe(gulp.dest('./static/build/css/')) .pipe(rename({ suffix: '.min' })) .pipe(minifycss()) .pipe(gulp.dest('./static/build/css')); }); // 合并,压缩js文件 gulp.task('min-javascripts', function() { gulp.src('./static/js/*.js') .pipe(concat('all.js')) .pipe(gulp.dest('./static/build/js')) .pipe(rename({ suffix: '.min' })) .pipe(uglify()) .pipe(gulp.dest('./static/build/js')); }); // 定义develop任务发布或者运行时使用 gulp.task('develop',function(){ gulp.run('min-styles','min-javascripts'); }); // gulp命令默认启动的就是default gulp.task('default', function() { // 监听.css文件,一旦有变化,立刻调用min-styles任务执行 gulp.watch('./css/*.css', ['min-styles']); gulp.run('develop'); });