使用 gulp 构建一个项目

本章将介绍

  • gulp-watch-path
  • stream-combiner2
  • gulp-sourcemaps
  • gulp-autoprefixer

您还可以直接学习以下模块：

并将之前所有章节的内容组合起来编写一个前端项目所需的 gulp 代码。

若你不了解npm 请务必阅读 npm模块管理器

package.json

如果你熟悉 npm 则可以利用 package.json 保存所有 npm install --save-dev gulp-xxx 模块依赖和模块版本。

在命令行输入

npm init

会依次要求补全项目信息，不清楚的可以直接回车跳过

name: (gulp-demo)
version: (1.0.0)
description:
entry point: (index.js)
test command:
...
...
Is this ok? (yes)

最终会在当前目录中创建 package.json 文件并生成类似如下代码：

{
  "name": "gulp-demo",
  "version": "0.0.0",
  "description": "",
  "scripts": {
    "test": "echo \"Error: no test specified\" && exit 1"
  },
  "repository": {
    "type": "git",
    "url": "https://github.com/nimojs/gulp-demo.git"
  },
  "keywords": [
    "gulp",
  ],
  "author": "nimojs <[email protected]>",
  "license": "MIT",
  "bugs": {
    "url": "https://github.com/nimojs/gulp-demo/issues"
  },
  "homepage": "https://github.com/nimojs/gulp-demo"
}

安装依赖

安装 gulp 到项目（防止全局 gulp 升级后与此项目 gulpfile.js 代码不兼容）

npm install gulp --save-dev

此时打开 package.json 会发现多了如下代码

"devDependencies": {
    "gulp": "^3.8.11"
}

声明此项目的开发依赖 gulp

接着安装其他依赖：

安装模块较多，请耐心等待，若一直安装失败可使用npm.taobao.org

npm install gulp-uglify gulp-watch-path stream-combiner2 gulp-sourcemaps gulp-minify-css gulp-autoprefixer gulp-less gulp-ruby-sass gulp-imagemin gulp-util --save-dev

此时，package.json 将会更新

"devDependencies": {
    "colors": "^1.0.3",
    "gulp": "^3.8.11",
    "gulp-autoprefixer": "^2.1.0",
    "gulp-imagemin": "^2.2.1",
    "gulp-less": "^3.0.2",
    "gulp-minify-css": "^1.0.0",
    "gulp-ruby-sass": "^1.0.1",
    "gulp-sourcemaps": "^1.5.1",
    "gulp-uglify": "^1.1.0",
    "gulp-watch-path": "^0.0.7",
    "stream-combiner2": "^1.0.2"
}

当你将这份 gulpfile.js 配置分享给你的朋友时，就不需要将 node_modules/ 发送给他，他只需在命令行输入

npm install

就可以检测 package.json 中的 devDependencies 并安装所有依赖。

设计目录结构

我们将文件分为2类，一类是源码，一类是编译压缩后的版本。文件夹分别为 src 和 dist。(注意区分 dist 和 ·dest 的区别)

└── src/
│
└── dist/

dist/ 目录下的文件都是根据 src/ 下所有源码文件构建而成。

在 src/ 下创建前端资源对应的的文件夹

└── src/
	├── less/    *.less 文件
	├── sass/    *.scss *.sass 文件
	├── css/     *.css  文件
	├── js/      *.js 文件
	├── fonts/   字体文件
    └── images/   图片
└── dist/

让命令行输出的文字带颜色

gulp 自带的输出都带时间和颜色，这样很容易识别。我们利用 gulp-util 实现同样的效果。

var gulp = require(‘gulp‘)
var gutil = require(‘gulp-util‘)

gulp.task(‘default‘, function () {
    gutil.log(‘message‘)
    gutil.log(gutil.colors.red(‘error‘))
    gutil.log(gutil.colors.green(‘message:‘) + "some")
})

使用 gulp 启动默认任务以测试 

配置 JS 任务

gulp-uglify

检测src/js/目录下的 js 文件修改后，压缩 js/ 中所有 js 文件并输出到 dist/js/ 中

var uglify = require(‘gulp-uglify‘)

gulp.task(‘uglifyjs‘, function () {
    gulp.src(‘src/js/**/*.js‘)
        .pipe(uglify())
        .pipe(gulp.dest(‘dist/js‘))
})

gulp.task(‘default‘, function () {
    gulp.watch(‘src/js/**/*.js‘, [‘uglifyjs‘])
})

src/js/**/*.js 是 glob 语法。百度百科：glob模式 、node-glob

在命令行输入 gulp 后会出现如下消息，表示已经启动。

[20:39:50] Using gulpfile ~/Documents/code/gulp-book/demo/chapter7/gulpfile.js
[20:39:50] Starting ‘default‘...
[20:39:50] Finished ‘default‘ after 13 ms

此时编辑 src/js/log.js 文件并保存，命令行会出现如下消息，表示检测到 src/js/**/*.js 文件修改后重新编译所有 js。

[20:39:52] Starting ‘js‘...
[20:39:52] Finished ‘js‘ after 14 ms

gulp-watch-path

此配置有个性能问题，当 gulp.watch 检测到 src/js/ 目录下的js文件有修改时会将所有文件全部编译。实际上我们只需要重新编译被修改的文件。

简单介绍 gulp.watch 第二个参数为 function 时的用法。

gulp.watch(‘src/js/**/*.js‘, function (event) {
    console.log(event);
    /*
    当修改 src/js/log.js 文件时
    event {
        // 发生改变的类型，不管是添加，改变或是删除
        type: ‘changed‘,
        // 触发事件的文件路径
        path: ‘/Users/nimojs/Documents/code/gulp-book/demo/chapter7/src/js/log.js‘
    }
    */
})

我们可以利用 event 给到的信息，检测到某个 js 文件被修改时，只编写当前修改的 js 文件。

可以利用 gulp-watch-path 配合 event 获取编译路径和输出路径。

var watchPath = require(‘gulp-watch-path‘)

gulp.task(‘watchjs‘, function () {
    gulp.watch(‘src/js/**/*.js‘, function (event) {
        var paths = watchPath(event, ‘src/‘, ‘dist/‘)
        /*
        paths
            { srcPath: ‘src/js/log.js‘,
              srcDir: ‘src/js/‘,
              distPath: ‘dist/js/log.js‘,
              distDir: ‘dist/js/‘,
              srcFilename: ‘log.js‘,
              distFilename: ‘log.js‘ }
        */
        gutil.log(gutil.colors.green(event.type) + ‘ ‘ + paths.srcPath)
        gutil.log(‘Dist ‘ + paths.distPath)

        gulp.src(paths.srcPath)
            .pipe(uglify())
            .pipe(gulp.dest(paths.distDir))
    })
})

gulp.task(‘default‘, [‘watchjs‘])

watchPath(event, search, replace, distExt)

参数 说明
event gulp.watch 回调函数的 event
search 需要被替换的起始字符串
replace 第三个参数是新的的字符串
distExt 扩展名(非必填)

此时编辑 src/js/log.js 文件并保存，命令行会出现消息，表示检测到 src/js/log.js 文件修改后只重新编译 log.js。

[21:47:25] changed src/js/log.js
[21:47:25] Dist dist/js/log.js

stream-combiner2

编辑 log.js 文件时，如果文件中有 js 语法错误时，gulp 会终止运行并报错。

当 log.js 缺少 )

log(‘gulp-book‘

并保存文件时出现如下错误，但是错误信息不全面。而且还会让 gulp 停止运行。

events.js:85
      throw er; // Unhandled ‘error‘ event
            ^
Error
    at new JS_Parse_Error (/Users/nimojs/Documents/code/gulp-book/demo/chapter7/node_modules/gulp-uglify/node_modules/uglify-js/lib/parse.js:189:18)
...
...
js_error (/Users/nimojs/Documents/code/gulp-book/demo/chapter7/node_modules/gulp-
-book/demo/chapter7/node_modules/gulp-uglify/node_modules/uglify-js/lib/parse.js:1165:20)
    at maybe_unary (/Users/nimojs/Documents/code/gulp-book/demo/chapter7/node_modules/gulp-uglify/node_modules/uglify-js/lib/parse.js:1328:19)

应对这种情况，我们可以使用  stream-combiner2 捕获错误信息。

var handleError = function (err) {
    var colors = gutil.colors;
    console.log(‘\n‘)
    gutil.log(colors.red(‘Error!‘))
    gutil.log(‘fileName: ‘ + colors.red(err.fileName))
    gutil.log(‘lineNumber: ‘ + colors.red(err.lineNumber))
    gutil.log(‘message: ‘ + err.message)
    gutil.log(‘plugin: ‘ + colors.yellow(err.plugin))
}
var combiner = require(‘stream-combiner2‘)

gulp.task(‘watchjs‘, function () {
    gulp.watch(‘src/js/**/*.js‘, function (event) {
        var paths = watchPath(event, ‘src/‘, ‘dist/‘)
        /*
        paths
            { srcPath: ‘src/js/log.js‘,
              srcDir: ‘src/js/‘,
              distPath: ‘dist/js/log.js‘,
              distDir: ‘dist/js/‘,
              srcFilename: ‘log.js‘,
              distFilename: ‘log.js‘ }
        */
        gutil.log(gutil.colors.green(event.type) + ‘ ‘ + paths.srcPath)
        gutil.log(‘Dist ‘ + paths.distPath)

        var combined = combiner.obj([
            gulp.src(paths.srcPath),
            uglify(),
            gulp.dest(paths.distDir)
        ])

        combined.on(‘error‘, handleError)
    })
})

此时当编译错误的语法时，命令行会出现错误提示。而且不会让 gulp 停止运行。

changed:src/js/log.js
dist:dist/js/log.js
--------------
Error!
fileName: /Users/nimojs/Documents/code/gulp-book/demo/chapter7/src/js/log.js
lineNumber: 7
message: /Users/nimojs/Documents/code/gulp-book/demo/chapter7/src/js/log.js: Unexpected token eof ?undefined?, expected punc ?,?
plugin: gulp-uglify

gulp-sourcemaps

JS 压缩前和压缩后比较

// 压缩前
var log = function (msg) {
    console.log(‘--------‘);
    console.log(msg)
    console.log(‘--------‘);
}
log({a:1})
log(‘gulp-book‘)

// 压缩后
var log=function(o){console.log("--------"),console.log(o),console.log("--------")};log({a:1}),log("gulp-book");

压缩后的代码不存在换行符和空白符，导致出错后很难调试，好在我们可以使用 sourcemap 帮助调试

var sourcemaps = require(‘gulp-sourcemaps‘)
// ...
var combined = combiner.obj([
    gulp.src(paths.srcPath),
    sourcemaps.init(),
    uglify(),
    sourcemaps.write(‘./‘),
    gulp.dest(paths.distDir)
])
// ...

此时 dist/js/ 中也会生成对应的 .map 文件


至此，我们完成了检测文件修改后压缩 JS 的 gulp 任务配置。

有时我们也需要一次编译所有 js 文件。可以配置 uglifyjs 任务。

gulp.task(‘uglifyjs‘, function () {
    var combined = combiner.obj([
        gulp.src(‘src/js/**/*.js‘),
        sourcemaps.init(),
        uglify(),
        sourcemaps.write(‘./‘),
        gulp.dest(‘dist/js/‘)
    ])
    combined.on(‘error‘, handleError)
})

在命令行输入 gulp uglifyjs 以压缩 src/js/ 下的所有 js 文件。

配置 CSS 任务

有时我们不想使用 LESS 或 SASS而是直接编写 CSS，但我们需要压缩 CSS 以提高页面加载速度。

gulp-minify-css

按照本章中压缩 JS 的方式，先编写 watchcss 任务

var minifycss = require(‘gulp-minify-css‘)

gulp.task(‘watchcss‘, function () {
    gulp.watch(‘src/css/**/*.css‘, function (event) {
        var paths = watchPath(event, ‘src/‘, ‘dist/‘)

        gutil.log(gutil.colors.green(event.type) + ‘ ‘ + paths.srcPath)
        gutil.log(‘Dist ‘ + paths.distPath)

        gulp.src(paths.srcPath)
            .pipe(sourcemaps.init())
            .pipe(minifycss())
            .pipe(sourcemaps.write(‘./‘))
            .pipe(gulp.dest(paths.distDir))
    })
})

gulp.task(‘default‘, [‘watchjs‘,‘watchcss‘])

gulp-autoprefixer

autoprefixer 解析 CSS 文件并且添加浏览器前缀到CSS规则里。 通过示例帮助理解

autoprefixer 处理前：

.demo {
    display:flex;
}

autoprefixer 处理后：

.demo {
    display:-webkit-flex;
    display:-ms-flexbox;
    display:flex;
}

你只需要关心编写标准语法的 css，autoprefixer 会自动补全。

在 watchcss 任务中加入 autoprefixer:

gulp.task(‘watchcss‘, function () {
    gulp.watch(‘src/css/**/*.css‘, function (event) {
        var paths = watchPath(event, ‘src/‘, ‘dist/‘)

        gutil.log(gutil.colors.green(event.type) + ‘ ‘ + paths.srcPath)
        gutil.log(‘Dist ‘ + paths.distPath)

        gulp.src(paths.srcPath)
            .pipe(sourcemaps.init())
            .pipe(autoprefixer({
              browsers: ‘last 2 versions‘
            }))
            .pipe(minifycss())
            .pipe(sourcemaps.write(‘./‘))
            .pipe(gulp.dest(paths.distDir))
    })
})

有时我们也需要一次编译所有 css 文件。可以配置 minifyss 任务。

gulp.task(‘minifycss‘, function () {
    gulp.src(‘src/css/**/*.css‘)
        .pipe(sourcemaps.init())
        .pipe(autoprefixer({
          browsers: ‘last 2 versions‘
        }))
        .pipe(minifycss())
        .pipe(sourcemaps.write(‘./‘))
        .pipe(gulp.dest(‘dist/css/‘))
})

在命令行输入 gulp minifyss 以压缩 src/css/ 下的所有 .css 文件并复制到 dist/css 目录下

配置 Less 任务

参考配置 JavaScript 任务的方式配置 less 任务

var less = require(‘gulp-less‘)

gulp.task(‘watchless‘, function () {
    gulp.watch(‘src/less/**/*.less‘, function (event) {
        var paths = watchPath(event, ‘src/less/‘, ‘dist/css/‘)

        gutil.log(gutil.colors.green(event.type) + ‘ ‘ + paths.srcPath)
        gutil.log(‘Dist ‘ + paths.distPath)
        var combined = combiner.obj([
            gulp.src(paths.srcPath),
            sourcemaps.init(),
            autoprefixer({
              browsers: ‘last 2 versions‘
            }),
            less(),
            minifycss(),
            sourcemaps.write(‘./‘),
            gulp.dest(paths.distDir)
        ])
        combined.on(‘error‘, handleError)
    })
})

gulp.task(‘lesscss‘, function () {
    var combined = combiner.obj([
            gulp.src(‘src/less/**/*.less‘),
            sourcemaps.init(),
            autoprefixer({
              browsers: ‘last 2 versions‘
            }),
            less(),
            minifycss(),
            sourcemaps.write(‘./‘),
            gulp.dest(‘dist/css/‘)
        ])
    combined.on(‘error‘, handleError)
})

gulp.task(‘default‘, [‘watchjs‘, ‘watchcss‘, ‘watchless‘])

配置 Sass 任务

参考配置 JavaScript 任务的方式配置 Sass 任务

gulp.task(‘watchsass‘,function () {
    gulp.watch(‘src/sass/**/*‘, function (event) {
        var paths = watchPath(event, ‘src/sass/‘, ‘dist/css/‘)

        gutil.log(gutil.colors.green(event.type) + ‘ ‘ + paths.srcPath)
        gutil.log(‘Dist ‘ + paths.distPath)
        sass(paths.srcPath)
            .on(‘error‘, function (err) {
                console.error(‘Error!‘, err.message);
            })
            .pipe(sourcemaps.init())
            .pipe(minifycss())
            .pipe(autoprefixer({
              browsers: ‘last 2 versions‘
            }))
            .pipe(sourcemaps.write(‘./‘))
            .pipe(gulp.dest(paths.distDir))
    })
})

gulp.task(‘sasscss‘, function () {
        sass(‘src/sass/‘)
        .on(‘error‘, function (err) {
            console.error(‘Error!‘, err.message);
        })
        .pipe(sourcemaps.init())
        .pipe(minifycss())
        .pipe(autoprefixer({
          browsers: ‘last 2 versions‘
        }))
        .pipe(sourcemaps.write(‘./‘))
        .pipe(gulp.dest(‘dist/css‘))
})

gulp.task(‘default‘, [‘watchjs‘, ‘watchcss‘, ‘watchless‘, ‘watchsass‘, ‘watchsass‘])

配置 image 任务

var imagemin = require(‘gulp-imagemin‘)

gulp.task(‘watchimage‘, function () {
    gulp.watch(‘src/images/**/*‘, function (event) {
        var paths = watchPath(event,‘src/‘,‘dist/‘)

        gutil.log(gutil.colors.green(event.type) + ‘ ‘ + paths.srcPath)
        gutil.log(‘Dist ‘ + paths.distPath)

        gulp.src(paths.srcPath)
            .pipe(imagemin({
                progressive: true
            }))
            .pipe(gulp.dest(paths.distDir))
    })
})

gulp.task(‘image‘, function () {
    gulp.src(‘src/images/**/*‘)
        .pipe(imagemin({
            progressive: true
        }))
        .pipe(gulp.dest(‘dist/images‘))
})

配置文件复制任务

复制 src/fonts/ 文件到 dist/ 中

gulp.task(‘watchcopy‘, function () {
    gulp.watch(‘src/fonts/**/*‘, function (event) {
        var paths = watchPath(event)

        gutil.log(gutil.colors.green(event.type) + ‘ ‘ + paths.srcPath)
        gutil.log(‘Dist ‘ + paths.distPath)

        gulp.src(paths.srcPath)
            .pipe(gulp.dest(paths.distDir))
    })
})

gulp.task(‘copy‘, function () {
    gulp.src(‘src/fonts/**/*‘)
        .pipe(gulp.dest(‘dist/fonts/‘))
})

gulp.task(‘default‘, [‘watchjs‘, ‘watchcss‘, ‘watchless‘, ‘watchsass‘, ‘watchimage‘, ‘watchcopy‘])
时间： 2024-10-13 13:06:34

使用 gulp 构建一个项目的相关文章

2016-7-15(1)使用gulp构建一个项目

gulp是前端开发过程中自动构建项目的工具,相同作用的还有grunt.构建工具依 靠插件能够自动监测文件变化以及完成js/sass/less/html/image/css/coffee等文件的语法检查.合并.重命名.压缩.格式 化.浏览器自动刷新.部署文件等功能. gulp是基于Nodejs的自动运行器,他借鉴了Unix操作系统的管道(pipe)思想,前一级的输出是后一级的输入.下面是具体流程: 1.安装nodejs nodejs下载地址:https://nodejs.org/ nodejs自带

使用gulp构建一个项目

gulp是前端开发过程中自动构建项目的工具,相同作用的还有grunt.构建工具依靠插件能够自动监测文件变化以及完成js/sass/less/html/image/css/coffee等文件的语法检查.合并.重命名.压缩.格式化.浏览器自动刷新.部署文件等功能. gulp是基于Nodejs的自动运行器,他借鉴了Unix操作系统的管道(pipe)思想,前一级的输出是后一级的输入.下面是具体流程: 1.安装nodejsnodejs下载地址:https://nodejs.org/ nodejs自带npm

4、Jenkins 使用maven构建一个项目

一.使用maven构建项目的前提: 请确保jenkins服务器上安装配置了maven软件,如果不清楚如何安装配置,请参考前面第二篇jenkins的安装配置. 二.如何构建一个项目 登录jenkins服务器,在主页左侧菜单栏点击"新建" 在Item名称后面输入项目名称,名字随便起,为避免编码问题,请使用英文.然后选择下面的"构建一个maven项目"点击OK 在源码管理这里选择Git,因为我的代码都在Git仓库里面."Repository URL"这

Gulp构建Android项目，安装APK

Gulp构建Android项目,安装APK 上一节Gulp安装及使用这篇文章中说到,Gulp可以执行终端命令,是不是有很多想法呢,:) 这篇没有多少技术性,仅供娱乐 测试环境 Mac:10.10.4 Gulp:3.9.0 Android studio:1.3 time:2015年08月21日17:29:07 前提 整个Android项目在Android studio中已经编译好,可以正常运行.如果没有编译好的话,只能是在终端输出错误日志了. 文件目录 root |----gulpfils.js

gulp构建自动化项目

'use strict'; var gulp = require('gulp'), browserSync = require('browser-sync').create(), SSI = require('browsersync-ssi'),//多浏览器多设备同步&自动刷新 concat = require('gulp-concat'),//整合文件 uglify = require('gulp-uglify'), //混淆js 暂时没用到 minify = require('gulp-mi

《移动Web前端高效开发实战》笔记2——使用Gulp构建一个ECMAScript 6和Sass应用

8.3.1 安装和配置 运行Gulp需要Node.js环境,请参看第二章内容搭建Node.js环境.使用NPM全局安装Gulp,命令如下: npm install gulp-cli –g 然后,在项目根目录下创建package.json文件,命令如下: npm init 根据引导配置项目信息.然后安装Gulp依赖包,命令如下: npm install gulp –save-dev 在项目根目录下,创建gulpfile.js文件,内容如下: var gulp = require("gulp&quo

Vue+webpack构建一个项目

1.安装CLI命令的工具  推荐用淘宝的镜像 npm install -g @vue/cli @vue/cli-init 2.使用命令构建一个名为myapp的项目 vue init webpack myapp vue -v 可以查看版本号(V大写)----------------------------构建项目信息详解 - Project name:项目名 - Project description: 项目描述 - Author: 作者 - Vue build: - 第一种:配合大部分的开发人员

grunt构建一个项目

准备工作:grunt基于node环境运行,所有先安装node.js 1.安装grunt,通过node的npm的包管理工具 >npm install grunt --save-dev 2.npm init在项目中引导创建一个package.json文件 >npm init 3.新建一个Gruntfile的js文件,主要是写入grunt的配置 module.exprots = function(grunt){ grunt.initConfig({此处写配置的信息}) }  4.几个常用的插件  

python构建一个项目

二.实验步骤 2.1 实验准备 我们的实验项目名为 factorial. $ mkdir factorial $ cd factorial/ 2.2 主代码 我们给将要创建的 Python 模块取名为 myfact,因此我们下一步创建 myfact 目录. $ mkdir myfact $ cd myfact/ 主代码将在 fact.py 文件里面. "myfact module" def factorial(num): """ 返回给定数字的阶乘值 :a