Grunt
安装 grunt 和 grunt-contrib-uglify
npm i grunt grunt-contrib-uglify -D
Gruntfile
Gruntfile.js 或 Gruntfile.coffee 文件是有效的 JavaScript 或 CoffeeScript 文件,应当放在你的项目根目录中,和 package.json 文件在同一目录层级,并和项目源码一起加入源码管理器。
Gruntfile 由以下几部分构成:
- “wrapper” 函数
- 项目与任务配置
- 加载 grunt 插件和任务
- 自定义任务
示例
module.exports = (grunt) => {
// 在这里写与grunt有关的功能
// 项目配置
grunt.initConfig({
pkg: grunt.file.readJSON('package.json'),
uglify: {
options: {
banner:
'/*! <%= pkg.name %> <%= grunt.template.today("yyyy-mm-dd") %> */\n',
},
build: {
src: 'src/js/<%= pkg.name %>.js',
dest: 'dist/js/<%= pkg.name %>.min.js',
},
},
});
// 加载能够提供"uglify"任务的插件。
grunt.loadNpmTasks('grunt-contrib-uglify');
// Default task(s).
grunt.registerTask('default', ['log', 'uglify']);
grunt.registerTask('log', '打印日志', () => {
console.log('执行打印日志');
});
};
下面我们来逐步分析
“wrapper” 函数
每一份 Gruntfile (和 grunt 插件)都遵循同样的格式,你所书写的 Grunt 代码必须放在此函数内:
module.exports = (grunt) => {
// 在这里写与grunt有关的功能
};
项目和任务配置
大部分的 Grunt 任务都依赖某些配置数据,这些数据被定义在一个 object 内,并传递给 grunt.initConfig
方法。
在下面的案例中,grunt.file.readJSON('package.json')
将存储在 package.json 文件中的 JSON 元数据引入到 grunt config 中。 由于<% %>
模板字符串可以引用任意的配置属性,因此可以通过这种方式来指定诸如文件路径和文件列表类型的配置数据,从而减少一些重复的工作。
你可以在这个配置对象中(传递给 initConfig()方法的对象)存储任意的数据,只要它不与你任务配置所需的属性冲突,否则会被忽略。此外,由于这本身就是 JavaScript,你不仅限于使用 JSON;你可以在这里使用任意的有效的 JS 代码。如果有必要,你甚至可以以编程的方式生成配置。
与大多数 task 一样,grunt-contrib-uglify
插件中的 uglify
任务要求它的配置被指定在一个同名属性中。在这里有一个例子, 我们指定了一个 banner
选项(用于在文件顶部生成一个注释),紧接着是一个单一的名为 build
的 uglify
目标,用于将一个 js 文件压缩为一个目标文件。
module.exports = (grunt) => {
// 在这里写与grunt有关的功能
// 项目配置
grunt.initConfig({
pkg: grunt.file.readJSON('package.json'),
uglify: {
options: {
banner:
'/*! <%= pkg.name %> <%= grunt.template.today("yyyy-mm-dd") %> */\n',
},
build: {
src: 'src/<%= pkg.name %>.js',
dest: 'dist/<%= pkg.name %>.min.js',
},
},
});
};
加载 Grunt 插件和任务
像 concatenation、[minification]、grunt-contrib-uglify 和 linting 这些常用的任务(task)都已经以 grunt 插件的形式被开发出来了。只要在 package.json 文件中被列为 dependency(依赖)的包,并通过 npm install 安装之后,都可以在 Gruntfile 中以简单命令的形式使用:
// 加载能够提供"uglify"任务的插件。
grunt.loadNpmTasks('grunt-contrib-uglify');
注意: grunt --help
命令将列出所有可用的任务。
自定义任务
通过定义 default
任务,可以让 Grunt
默认执行一个或多个任务。在下面的这个案例中,执行 grunt
命令时如果不指定一个任务的话,将会执行 uglify
任务。这和执行 grunt uglify
或者 grunt default
的效果一样。default
任务列表数组中可以指定任意数目的任务(可以带参数)。
// Default task(s).
grunt.registerTask('default', ['log', 'uglify']);
grunt.registerTask('log', '打印日志', () => {
console.log('执行打印日志');
});