RequireJs 提供了一个打包工具 r.js,可以将相关的模块打包为一个文件。相关说明:http://www.requirejs.org/docs/optimization.html
- 将相关的脚本模块整合为单个脚本文件,然后默认使用 UglifyJS 进行紧缩,或者在使用 java 的时候,使用 Closure Compiler 处理。
- 还可以通过 @import 自动内联相应的样式,并且删除注释来优化 CSS
虽然可以通过命令行来使用这个打包工具,但是在 Grunt 中也提供了相应的插件来自动完成这个任务。
1. 安装
地址:https://github.com/gruntjs/grunt-contrib-requirejs
npm install grunt-contrib-requirejs --save-dev
控制台输出
grunt-contrib-requirejs@0.4.4 node_modules\grunt-contrib-requirejs
└── requirejs@2.1.20
在 Gruntfile.js 文件中,使用 grunt.loadNpmTasks 来加载这个任务。
grunt.loadNpmTasks('grunt-contrib-requirejs');
2. 配置
module.exports = function(grunt) { // Project configuration.
grunt.initConfig({
pkg: grunt.file.readJSON('package.json'), copy: {
dev: {
files: [
{expand: true, src: ['src/**/*.js'], dest: 'public/js', filter: 'isFile'}
]
}
}, requirejs: {
compile: {
options: {
name: "main",
baseUrl: "src/js",
mainConfigFile: "main.js",
out: "public/js/main.js"
}
}
} }); // 加载包含 "copy" 任务的插件。
grunt.loadNpmTasks('grunt-contrib-copy'); grunt.loadNpmTasks('grunt-contrib-requirejs'); // 默认被执行的任务列表。
grunt.registerTask('default', ['uglify']); };
compile 是我们为任务所起名称,options 中是相应的配置。
- baseUrl, 类似于 requirejs 中的 baseUrl 参数,用来定义脚本的参照地址。
- mainConfigFile: requirejs 的配置文件,工具通过它来获取 requirejs 的配置信息。它的地址要相对于 baseUrl 地址。
- name, 入口模块的地址,也就是我们的入口模块,这里是模块名称,所以不需要 .js 的扩展名,地址也要相对于 baseUrl 地址。如果你使用了 almond 进行压缩,almond相当于入口模块了,这里就是 almond 的地址。也不需要 .js 扩展名。
- out, 输出的结果,这个地址与 baseUrl 没有关系,是相对于 Gruntfile.js 的地址
- include 需要包含的模块名称,如果使用了 almond,入口已经变成 almond 了,就必须要包含原始的入口模块名称。
2.1 直接使用 r.js
在使用这个紧缩任务的时候,默认是不包含 require.js 库的,所以有两种用法。
第一种用法,只紧缩我们定义的模块,这样紧缩出来的结果中,会包含 require 过的第三方库,比如 jquery, angularjs 等等,但是不会包含 requirejs 本身。所以,我们需要在页面中先引用 require.js 库,然后引用我们紧缩的结果。
requirejs: {
compile: {
options: {
name: "main",
baseUrl: "src/js",
mainConfigFile: "main.js",
out: "public/js/main.js"
}
}
}
第二种用法,直接将 require.js 也包含进来,这样,只需要在页面中引用紧缩的结果即可。
先通过 paths 给 require.js 起一个名称,然后在 include 中包含这个模块。
//Set paths for modules. If relative paths, set relative to baseUrl above.
//If a special value of "empty:" is used for the path value, then that
//acts like mapping the path to an empty file. It allows the optimizer to
//resolve the dependency to path, but then does not include it in the output.
//Useful to map module names that are to resources on a CDN or other
//http: URL when running in the browser and during an optimization that
//file should be skipped because it has no dependencies.
paths: {
"requireLib": "lib/require"
}, include: ["requireLib"],
2.2 使用 almond
在使用 almond 的时候,其实更加简单了。
我们将 name 设置为 almond 的路径,然后使用 include 将我们实际的入口模块包含进来就可以了。
这里需要注意一点,almond 是一个独立的脚本库,你需要自己将这个库下载来下,直接使用 bower 就可以。然后,设置 name 为相对于 baseUrl 的 almond 库路径即可。
requirejs: {
compile: {
options: {
baseUrl: "tmp",
mainConfigFile: "tmp/main.js",
include: "main",
name: "../bower_components/almond/almond",
out: "tmp/<%= pkg.name %>.js"
}
}
}
注意,上面的官方实例中没有使用 include 包含实际的入口。结果就是不会执行的你的脚本。
关于 almond 的限制
- 将所有的模块合并到单个文件,不会再有动态加载。
- 所有的模块都拥有唯一的标识,以及通过 define() 来说明的模块所依赖的模块说明数组,requirejs 优化器通过它来检查模块关系。
- 只能使用一次 requirejs.config() 调用
- requirejs.config 需要包含在输出中,这对于 map config 很重要
- 不支持 var require = {} 来传递配置参数
- 不支持 RequireJS multiversion support/contexts.
- 不要使用 require.toRul() 或者 require.nameToUrl()
- 不要使用 packages/packagePaths config.
仍然支持的特性:
- 使用相对路径的依赖
- define('id', {}) 定义
- define(), require() 和 requirejs() 调用
- 将插件合并到优化之后的文件中,在优化之后可以同步访问这些资源。