本文假设你之前没有用过任何任务脚本(task runner)和命令行工具,一步步教你上手Gulp。不要怕,它其实很简单,我会分为五步向你介绍gulp并帮助你完成一些惊人的事情。那就直接开始吧。
第一步:安装Node
首先,最基本也最重要的是,我们需要搭建node环境。访问http://nodejs.org,然后点击大大的绿色的install
按钮,下载完成后直接运行程序,就一切准备就绪。npm会随着安装包一起安装,稍后会用到它。
第二步:使用命令行
也许现在你还不是很了解什么是命令行——OSX中的终端(Terminal),windows中的命令提示符(Command Prompt),但很快你就会知道。它看起来没那么简单,但一旦掌握了它的窍门,就可以很方便的执行很多命令行程序,比如Sass,Yeoman和Git等,这些都是非常有用的工具。
如果你很熟悉命令行,直接跳到步骤四。
为了确保Node已经正确安装,我们执行几个简单的命令。
node -v
回车(Enter),如果正确安装的话,你会看到所安装的Node的版本号,接下来看看npm。
npm -v
这同样能得到npm的版本号。
如果这两行命令没有得到返回,可能node就没有安装正确,尝试重启下命令行工具,如果还不行的话,只能回到第一步进行重装。
第三步:定位到项目
现在,我们已经大致了解了命令行并且知道如何简单使用它,接下来只需要两个简单的命令就能定位到文件目录并看看目录里都有些什么文件。
- cd,定位到目录
- ls,列出文件列表
建议多敲敲这两个命令,了解文件系统并知道文件都在哪里。
习惯使用了这两个命令后,就要进入我们的项目目录,这个目录各不相同,举个例子,这是我进入我项目目录的命令:
cd /Applications/XAMPP/xamppfiles/htdocs/my-project
成功进入项目目录后,我们开始安装gulp。
第四步:安装gulp
我们已经知道如何使用命令行,现在尝试点新的东西,认识npm然后安装gulp。
NPM是基于命令行的node包管理工具,它可以将node的程序模块安装到项目中,在它的官网中可以查看和搜索所有可用的程序模块。
在命令行中输入
sudo npm install -g gulp
- sudo是以管理员身份执行命令,一般会要求输入电脑密码
-
npm是安装node模块的工具,执行install命令
-
-g表示在全局环境安装,以便任何项目都能使用它
- 最后,gulp是将要安装的node模块的名字
运行时注意查看命令行有没有错误信息,安装完成后,你可以使用下面的命令查看gulp的版本号以确保gulp已经被正确安装。
gulp -v
接下来,我们需要将gulp安装到项目本地
npm install —-save-dev gulp
这里,我们使用—-save-dev
来更新package.json文件,更新devDependencies
值,以表明项目需要依赖gulp。
Dependencies
可以向其他参与项目的人指明项目在开发环境和生产环境中的node模块依懒关系,想要更加深入的了解它可以看看package.json文档。
第五步:新建Gulpfile文件,运行gulp
安装好gulp后我们需要告诉它要为我们执行哪些任务,首先,我们自己需要弄清楚项目需要哪些任务。
- 检查Javascript
- 编译Sass(或Less之类的)文件
- 合并Javascript
- 压缩并重命名合并后的Javascript
安装依赖
npm install gulp-jshint gulp-sass gulp-concat gulp-uglify gulp-rename --save-dev
提醒下,如果以上命令提示权限错误,需要添加
sudo
再次尝试。
新建gulpfile文件
现在,组件都安装完毕,我们需要新建gulpfile文件以指定gulp需要为我们完成什么任务。
gulp只有五个方法: task
,run
,watch
,src
,和dest
,在项目根目录新建一个js文件并命名为gulpfile.js,把下面的代码粘贴进去:
gulpfile.js
1 // 引入 gulp 2 var gulp = require('gulp'); 3 4 // 引入组件 5 var jshint = require('gulp-jshint'); 6 var sass = require('gulp-sass'); 7 var concat = require('gulp-concat'); 8 var uglify = require('gulp-uglify'); 9 var rename = require('gulp-rename'); 10 11 // 检查脚本 12 gulp.task('lint', function() { 13 gulp.src('./js/*.js') 14 .pipe(jshint()) 15 .pipe(jshint.reporter('default')); 16 }); 17 18 // 编译Sass 19 gulp.task('sass', function() { 20 gulp.src('./scss/*.scss') 21 .pipe(sass()) 22 .pipe(gulp.dest('./css')); 23 }); 24 25 // 合并,压缩文件 26 gulp.task('scripts', function() { 27 gulp.src('./js/*.js') 28 .pipe(concat('all.js')) 29 .pipe(gulp.dest('./dist')) 30 .pipe(rename('all.min.js')) 31 .pipe(uglify()) 32 .pipe(gulp.dest('./dist')); 33 }); 34 35 // 默认任务 36 gulp.task('default', function(){ 37 gulp.run('lint', 'sass', 'scripts'); 38 39 // 监听文件变化 40 gulp.watch('./js/*.js', function(){ 41 gulp.run('lint', 'sass', 'scripts'); 42 }); 43 });
现在,分段解释下这段代码。
引入组件
1 var gulp = require('gulp'); 2 3 var jshint = require('gulp-jshint'); 4 var sass = require('gulp-sass'); 5 var concat = require('gulp-concat'); 6 var uglify = require('gulp-uglify'); 7 var rename = require('gulp-rename');
这一步,我们引入了核心的gulp和其他依赖组件,接下来,分开创建lint, sass, scripts 和 default这四个不同的任务。
Lint任务
1 gulp.task('lint', function() { 2 gulp.src('./js/*.js') 3 .pipe(jshint()) 4 .pipe(jshint.reporter('default')); 5 });
Link任务会检查js/
目录下得js文件有没有报错或警告。
Sass任务
1 gulp.task('sass', function() { 2 gulp.src('./scss/*.scss') 3 .pipe(sass()) 4 .pipe(gulp.dest('./css')); 5 });
Sass任务会编译scss/
目录下的scss文件,并把编译完成的css文件保存到/css
目录中。
Scripts 任务
1 gulp.task('scripts', function() { 2 gulp.src('./js/*.js') 3 .pipe(concat('all.js')) 4 .pipe(gulp.dest('./dist')) 5 .pipe(rename('all.min.js')) 6 .pipe(uglify()) 7 .pipe(gulp.dest('./dist')); 8 });
scripts任务会合并js/
目录下得所有得js文件并输出到dist/
目录,然后gulp会重命名、压缩合并的文件,也输出到dist/
目录。
default任务
1 gulp.task('default', function(){ 2 gulp.run('lint', 'sass', 'scripts'); 3 gulp.watch('./js/*.js', function(){ 4 gulp.run('lint', 'sass', 'scripts'); 5 }); 6 });
这时,我们创建了一个基于其他任务的default任务。使用.run()
方法关联和运行我们上面定义的任务,使用.watch()
方法去监听指定目录的文件变化,当有文件变化时,会运行回调定义的其他任务。
现在,回到命令行,可以直接运行gulp任务了。
gulp
这将执行定义的default任务,换言之,这和以下的命令式同一个意思
gulp default
当然,我们可以运行在gulpfile.js中定义的任意任务,比如,现在运行sass任务:
gulp sass
(Kimi: 哇塞,酷比了哎~)
结束语
现在已经做到了设置gulp任务然后运行他们,现在再回顾下之前学习的。
- 学习了安装Node环境
- 学习了简单使用命令行
- 学习了用命令行进入项目目录
- 学习了使用npm和安装gulp
- 学习了如何运行gulp任务
另外,有一些参考资源供进一步学习:
本文译自http://travismaynard.com/writing/getting-started-with-gulp