简介:
gulp是前端开发过程中对代码进行构建的工具,是自动化项目的构建利器;她不仅能对网站资源进行优化,而且在开发过程中很多重复的任务能够使用正确的工具自动完成;使用她,我们不仅可以很愉快的编写代码,而且大大提高我们的工作效率。
gulp是基于Nodejs的自动任务运行器, 她能自动化地完成 javascript/coffee/sass/less/html/image/css 等文件的的测试、检查、合并、压缩、格式化、浏览器自动刷新、部署文件生成,并监听文件在改动后重复指定的这些步骤。在实现上,她借鉴了Unix操作系统的管道(pipe)思想,前一级的输出,直接变成后一级的输入,使得在操作上非常简单。
ok开始说一些学习步骤:
安装nodejs -> 全局安装gulp -> 项目安装gulp以及gulp插件 -> 配置gulpfile.js -> 运行任务
1、
说明:gulp是基于nodejs,理所当然需要安装nodejs;
安装:打开nodejs官网,点击硕大的绿色Download按钮,它会根据系统信息选择对应版本(.msi文件)。然后像安装QQ一样安装它就可以了(安装路径随意)。
2、
简单介绍gulp在使用过程中常用命令,打开命令提示符执行下列命令(打开方式:window + r 输入cmd回车):
node -v查看安装的nodejs版本,出现版本号,说明刚刚已正确安装nodejs。PS:未能出现版本号,请尝试注销电脑重试;
npm -v查看npm的版本号,npm是在安装nodejs时一同安装的nodejs包管理器,那它有什么用呢?
cd定位到目录,用法:cd + 路径 ;
dir列出文件列表;
cls清空命令提示符窗口内容。
3、npm介绍
说明:npm(node package manager)nodejs的包管理器,用于node插件管理(包括安装、卸载、管理依赖等);
使用npm安装插件:命令提示符执行npm install <name> [-g] [--save-dev]
;
a、<name>:node插件名称。例:npm install gulp-less --save-dev
b、 -g:全局安装。将会安装在C:\Users\Administrator\AppData\Roaming\npm
,并且写入系统环境变量; 非全局安装:将会安装在当前定位目录; 全局安装可以通过命令行在任何地方调用它,本地安装将安装在定位目录的node_modules文件夹下,通过require()调用;
c、--save
:将保存配置信息至package.json(package.json是nodejs项目配置文件);
d、-dev:保存至package.json的devDependencies节点,不指定-dev将保存至dependencies节点;一般保存在dependencies的像这些express/ejs/body-parser等等。
e、为什么要保存至package.json?因为node插件包相对来说非常庞大,所以不加入版本管理,将配置信息写入package.json并将其加入版本管理,其他开发者对应下载即可(命令提示符执行npm install,则会根据package.json下载所有需要的包,npm install --production
只下载dependencies节点的包)。
f、使用npm卸载插件:npm uninstall <name> [-g] [--save-dev]
PS:不要直接删除本地插件包
g、删除全部插件:npm uninstall gulp-less gulp-uglify gulp-concat ……???太麻烦
h、借助rimraf:npm install rimraf -g 用法:rimraf node_modules
i、使用npm更新插件:npm update <name> [-g] [--save-dev]
j、更新全部插件:npm update [--save-dev]
k、查看npm帮助:npm help
l、当前目录已安装插件:npm list
4、cnmp
npm安装插件过程:从http://registry.npmjs.org下载对应的插件包(该网站服务器位于国外,所以经常下载缓慢或出现异常),淘宝团队为我们解决了这个问题,
http://npm.taobao.org这是一个完整 npmjs.org 镜像,可以用此代替官方版本(只读),同步频率目前为 10分钟 一次以保证尽量与官方服务同步。
安装:命令提示符执行npm install cnpm -g --registry=https://registry.npm.taobao.org
; 注意:安装完后最好查看其版本号cnpm -v或关闭命令提示符重新打开,安装完直接使用有可能会出现错误;
注:cnpm跟npm用法完全一致,只是在执行命令时将npm改为cnpm(以下操作将以cnpm代替npm)。
5、全局安装gulp
a、说明:全局安装gulp目的是为了通过她执行gulp任务;
b、安装:命令提示符执行cnpm install gulp -g;
c、查看是否正确安装:命令提示符执行gulp -v,出现版本号即为正确安装。
6、新建package.json文件
a、说明:package.json是基于nodejs项目必不可少的配置文件,它是存放在项目根目录的普通json文件;
b、它是这样一个json文件(注意:json文件内是不能写注释的,复制下列内容请删除注释):
{
"name": "test", //项目名称(必须)
"version": "1.0.0", //项目版本(必须)
"description": "This is for study gulp project !", //项目描述(必须)
"homepage": "", //项目主页
"repository": { //项目资源库
"type": "git",
"url": "https://git.oschina.net/xxxx"
},
"author": { //项目作者信息
"name": "surging",
"email": "surging2@qq.com"
},
"license": "ISC", //项目许可协议
"devDependencies": { //项目依赖的插件
"gulp": "^3.8.11",
"gulp-less": "^3.0.0"
}
}
当然我们可以手动新建这个配置文件,但是作为一名有志青年,我们应该使用更为效率的方法:命令提示符执行cnpm init
查看package.json帮助文档,命令提示符执行cnpm help package.json
接下来直接来点干的
操作之前先了解下面这几个单词或者说是方法
gulp.task(name, fn) 建立任务
gulp.run(tasks...) 尽可能多的并行运行多个task
gulp.watch(glob, fn) 当glob内容发生改变时,执行fn
gulp.src(glob) 返回一个可读的stream
gulp.dest(glob) 返回一个可写的stream
pipe(管道符) 管道操作
项目开始,先建一个目录resume
然后之前提到的方法在地址栏双击输入cmd进入命令行安装一系列插件
首先就是安装淘宝镜像:npm install -g cnpm --registry=https://registry.npm.taobao.org
接着依次安装运行以下命令
cnpm install gulp --save-dev
cnpm install gulp-htmlmin --save-dev
cnpm install gulp-imagemin --save-dev
cnpm install gulp-minify-css --save-dev
cnpm install gulp-rename --save-dev
cnpm install gulp-rev --save-dev
cnpm install gulp-rev-collector --save-dev
cnpm install gulp-sass --save-dev
cnpm install gulp-uglify --save-dev
cnpm install gulp-watch --save-dev
cnpm install gulp-watch-sequence --save-dev
cnpm install gulp-webserver --save-dev
安装完以后文件夹里面就会多出一些文件如下图:
接下来就是新建gulpfile.js文件了,找了以下网上的简单介绍:
说明:gulpfile.js是gulp项目的配置文件,是位于项目根目录的普通js文件(其实将gulpfile.js放入其他文件夹下亦可)。
它大概是这样一个js文件:
//导入工具包 require('node_modules里对应模块')
var gulp = require('gulp'), //本地安装gulp所用到的地方
less = require('gulp-less'); //定义一个testLess任务(自定义任务名称)
gulp.task('testLess', function () {
gulp.src('src/less/index.less') //该任务针对的文件
.pipe(less()) //该任务调用的模块
.pipe(gulp.dest('src/css')); //将会在src/css下生成index.css
}); gulp.task('default',['testLess', 'elseTask']); //定义默认任务 elseTask为其他任务,该示例没有定义elseTask任务 //gulp.task(name[, deps], fn) 定义任务 name:任务名称 deps:依赖任务名称 fn:回调函数
//gulp.src(globs[, options]) 执行任务处理的文件 globs:处理的文件路径(字符串或者字符串数组)
//gulp.dest(path[, options]) 处理完后文件生成路径
然后是自己新建的gulpfile.js文件:
// 基础gulp模块
var gulp = require('gulp');
// webserver服务器模块
var webserver = require('gulp-webserver'); //mock数据操作,需要引入url及fs,但是url/fs是内置的,所以不需要安装
var url = require('url');
var fs = require('fs'); // fs -> filesystem // sass转化
var sass = require('gulp-sass'); //js的模块化打包操作
var webpack = require('gulp-webpack'); //命名模块
var named = require('vinyl-named');
// cnpm install vinyl-named --save-dev var uglify = require('gulp-uglify'); var minifyCss = require('gulp-minify-css');
// cnpm install gulp-minify-css --save-dev //版本管理
var rev = require('gulp-rev');
//版本控制
var revCollector = require('gulp-rev-collector');
//监控
var watch = require('gulp-watch');
//队列模块
var sequence = require('gulp-watch-sequence'); /*
1.创建src(src是开发目录,所有操作都在src中进行)目录
2.在src新建index.html(因为我们现在做的是spa项目,所以,通过只有一个入口主文件)
3.实现index.html的文件复制操作,复制的目标是www
4.webserver的本地服务器配置(不是gulp-connect)
5.实现mock数据操作,先在根目录下创建mock目录,然后在目录里放置对应的json文件
mock文件有skill.json/project.json/work.json,对应的接口地址配置为/api/skill,/api/project,/api/work
6.实现sass转换
7.实现js的模块化开发操作
*/ gulp.task('copy-index',function(){
return gulp.src('./src/index.html')
.pipe(gulp.dest('./www'));
}); //创建本地服务器任务
gulp.task('webserver', function() {
gulp.src('./www')
.pipe(webserver({
livereload: true,
//directoryListing:true,
open:true,
port:1234, middleware:function(req,res,next){
//获取浏览器中的url,将url进行解析操作
var urlObj = url.parse(req.url,true),
method = req.method; //如果url里输出了/skill.php,/project.php或者是/work,
//那么我们就可以查找到urlObj.pathname为/skill.php,/project.php,/work
//然后我们就可以通过这个变化的url地址内容去判断并且返回相应的
//skill.json/project.json/work.json等数据文件的内容
switch(urlObj.pathname){
case '/skill':
// Content-Type可以指定返回的文件的格式类型
res.setHeader('Content-Type','application/json');
//需要通过fileSystem文件操作函数,去读取指定目录下的json文件,并将读取到的内容返回到浏览器端
fs.readFile('./mock/skill.json','utf-8',function(err,data){
res.end(data);
}); return; case '/project':
res.setHeader('Content-Type','application/json');
fs.readFile('./mock/project.json','utf-8',function(err,data){
res.end(data);
});
return; case '/work':
res.setHeader('Content-Type','application/json');
fs.readFile('./mock/work.json','utf-8',function(err,data){
res.end(data);
});
return;
} next(); // next是实现的循环
} // end middleware })); // end gulp
}); // index.css/main.scss--->www/css/index.css
// 通常我们主有一个入口的主文件index.scss/index.css
// @import 'xxx' gulp.task('sass',function(){
return gulp.src('./src/styles/index.scss')
.pipe(sass())
.pipe(minifyCss()) //css 压缩
.pipe(gulp.dest('./www/css'));
}) gulp.task('packjs',function(){
return gulp.src('./src/scripts/index.js')
.pipe(named())
.pipe(webpack())
.pipe(uglify()) // js丑化压缩
.pipe(gulp.dest('./www/js'));
}) //版本管理操作 var cssDistFiles = ['./www/css/index.css'];
var jsDistFiles = ['./www/js/index.js']; gulp.task('verCss',function(){
//找到要进行版本控制操作的目标文件
return gulp.src(cssDistFiles)
//生成相应的版本
.pipe(rev())
//复制到指定的目录
.pipe(gulp.dest('./www/css'))
//生成相应的映射文件
.pipe(rev.manifest())
//将映射文件复制到指定的目录
.pipe(gulp.dest('./www/ver/css'))
}) gulp.task('verJs',function(){
//找到要进行版本控制操作的目标文件
return gulp.src(jsDistFiles)
//生成相应的版本
.pipe(rev())
//复制到指定的目录
.pipe(gulp.dest('./www/js'))
//生成相应的映射文件
.pipe(rev.manifest())
//将映射文件复制到指定的目录
.pipe(gulp.dest('./www/ver/js'))
}) //文件的字符串替换操作
gulp.task('html',function(){
//src第一个参数是我们的映射资源文件,第二个参数是我们需要替换的html文件
gulp.src(['./www/ver/**/*.json','./www/*.html'])
//进行字符串替换操作
.pipe(revCollector({
replaceReved:true
}))
//复制文件到指定目录
.pipe(gulp.dest('./www'))
}) //监听操作
gulp.task('watch',function(){
gulp.watch('./src/index.html',['copy-index']); //设置队列
var queue = sequence(300);
watch('./src/scripts/**',{
name:"JS",
emitOnGlob:false
}, queue.getHandler('packjs','verJs','html')); watch('./src/styles/**',{
name:"CSS",
emitOnGlob:false
}, queue.getHandler('sass','verCss','html')); }); gulp.task('default',['webserver','watch'])
直接新建一个文件把上面的内容写进去就ok了,就是这样:
接下来就是新建一个src目录在里面做一些基本的文件配置:
上面是javascript里面放的,接下来就是样式里面创建的:
详细操作这里有视屏:js_data\第三阶段\视屏\day10(视屏里这一块的内容靠后)
类库所在地址js_data\第三阶段\课件\day07(iscroll类库和swiper类库)
准备工作差不多了,全部安装完成以后就运行gulp试试,可能会遇到以下问题:
还可能遇到下面的错误:
接下来就是最大的问题了:
解决办法:
还有一个小问题忘了,实在不行就ctr+c终端命令重启试试
这里就主要说一些问题,具体的东西视屏里面有,就不浪费时间了。
打开package.json就会看到如下代码(上面对package.json有介绍):
{
"name": "test", //项目名称(必须)
"version": "1.0.0", //项目版本(必须)
"description": "This is for study gulp project !", //项目描述(必须)
"homepage": "", //项目主页
"repository": { //项目资源库
"type": "git",
"url": "https://git.oschina.net/xxxx"
},
"author": { //项目作者信息
"name": "surging",
"email": "surging2@qq.com"
},
"license": "ISC", //项目许可协议
"devDependencies": { //项目依赖的插件
"gulp": "^3.8.11",
"gulp-less": "^3.0.0"
}
}
接下来在gulpBase文件夹中打开cmd命令行,并敲入命令npm init:
输入完文件名以后就一路敲回车(会出现一长串很长的代码):
补充:
1、*.scss :*号匹配当前目录任意文件,所以这里的*scss匹配当前目录下所有scss文件。
2、**/*.scss:匹配当前目录及其子目录的所有scss文件。
3、!not-me.scss:!号移除匹配的文件,这里将移除not-me.scss
4、*.+(scss|sass):+号后面会跟着圆括号,里面的元素用|分割,匹配多个选项,这里将匹配scss和sass文件。