Grunt是一个基于Node.js的JavaScript任务运行器,它可以帮助开发者自动化地完成任务,比如压缩、合并、测试等。本文将介绍如何使用Grunt来实现自动化任务。
首先,要使用Grunt,需要先安装Node.js。Node.js是一个JavaScript运行时环境,可以在服务端运行JavaScript代码。安装Node.js之后,就可以使用npm来安装Grunt了。
npm install -g grunt-cli
安装好Grunt之后,就可以开始使用Grunt了。首先,需要在项目根目录下创建一个package.json文件:
{ "name": "my-project", "version": "0.1.0", "devDependencies": { "grunt": "~0.4.5" } }
然后,在package.json所在的目录下创建一个Gruntfile.js文件:
module.exports = function(grunt) { // 配置 Grunt grunt.initConfig({ // 读取 package.json 的内容 pkg: grunt.file.readJSON('package.json'), // uglify 插件的配置信息 uglify: { options: { banner: '' }, build: { src: 'src/main/javascript/app*****', dest: 'build/main/javascript/app/app.<%= pkg .version %>.min .js' } } }); // 加载 uglify 插件 grunt .loadNpmTasks('grunt-contrib-uglify'); // 默认执行的任务 grunt .registerTask('default', ['uglify']); };
上面的代码中,我们通过grunt .initConfig()方法来初始化 Grunt 的配置信息。然后通过grunt .loadNpmTasks()方法来加载插件;最后通过grunt .registerTask()方法来注册要执行的任务。
最后,就可以执行 Grunt 的命令了。例如我想执行上面代码中注册的 default 任务:
grunt default
执行命令之后就会看到 Grunt 已经开始执行 default 任务了。当 Grunt 执行完成之后就会看到生成了 app.<%= pkg .version %>.min .js 文件了。
Grunt和 Grunt 插件是通过 npm 安装并管理的,npm是 Node.js 的包管理器。
Grunt 0.4.x 必须配合Node.js >= 0.8.0版本使用。;奇数版本号的 Node.js 被认为是不稳定的开发版。
在安装 Grunt 前,请确保当前环境中所安装的 npm 已经是最新版本,执行 npm update -g npm 指令进行升级(在某些系统中可能需要 sudo 指令)。
如果你已经安装了 Grunt,现在需要参考一些文档手册,那就请看一看 Gruntfile 实例 和如何 配置任务吧。
还在使用 Grunt 0.3 版本吗?请查看 Grunt 0.3 注意事项
在继续学习前,你需要先将Grunt命令行(CLI)安装到全局环境中。安装时可能需要使用sudo(针对OSX、*nix、BSD等系统中)权限或者作为管理员(对于Windows环境)来执行以下命令。
npm install -g grunt-cli
上述命令执行完后,grunt 命令就被加入到你的系统路径中了,以后就可以在任何目录下执行此命令了。
注意,安装grunt-cli并不等于安装了 Grunt!Grunt CLI的任务很简单:调用与Gruntfile在同一目录中 Grunt。这样带来的好处是,允许你在同一个系统上同时安装多个版本的 Grunt。
这样就能让多个版本的 Grunt 同时安装在同一台机器上。
每次运行grunt 时,他就利用node提供的require()系统查找本地安装的 Grunt。正是由于这一机制,你可以在项目的任意子目录中运行grunt 。
如果找到一份本地安装的 Grunt,CLI就将其加载,并传递Gruntfile中的配置信息,然后执行你所指定的任务。为了更好的理解 Grunt CLI的执行原理,请阅读源码。
假定Grunt CLI已经正确安装,并且已经有一份配置好package.json 和 Gruntfile 文件的项目了,接下来就很容易拿Grunt练手了:
OK,就是这么简单。还可以通过grunt --help 命令列出所有已安装的Grunt任务(task),但是一般更建议去查看项目的文档以获取帮助信息。
一般需要在你的项目中添加两份文件:package.json 和 Gruntfile。
package.json: 此文件被npm用于存储项目的元数据,以便将此项目发布为npm模块。你可以在此文件中列出项目依赖的grunt和Grunt插件,放置于devDependencies配置段内。
Gruntfile: 此文件被命名为 Gruntfile.js 或 Gruntfile.coffee,用来配置或定义任务(task)并加载Grunt插件的。 此文档中提到的 Gruntfile 其实说的是一个文件,文件名是 Gruntfile.js 或Gruntfile.coffee。
package.json应当放置于项目的根目录中,与Gruntfile在同一目录中,并且应该与项目的源代码一起被提交。在上述目录(package.json所在目录)中运行npm install将依据package.json文件中所列出的每个依赖来自动安装适当版本的依赖。
下面列出了几种为你的项目创建package.json文件的方式:
{ "name": "my-project-name", "version": "0.1.0", "devDependencies": { "grunt": "~0.4.5", "grunt-contrib-jshint": "~0.10.0", "grunt-contrib-nodeunit": "~0.4.1", "grunt-contrib-uglify": "~0.5.0" } }
向已经存在的package.json 文件中添加Grunt和grunt插件的最简单方式是通过npm install <module> --save-dev命令。此命令不光安装了<module>,还会自动将其添加到devDependencies 配置段中,遵循tilde version range格式。
例如,下面这条命令将安装Grunt最新版本到项目目录中,并将其添加到devDependencies内:
npm install grunt --save-dev
同样,grunt插件和其它node模块都可以按相同的方式安装。下面展示的实例就是安装 JSHint 任务模块:
npm install grunt-contrib-jshint --save-dev
在 Grunt 插件 页面可以看到当前可用的 Grunt 插件,他们可以直接在项目中安装并使用。
安装插件之后,请务必确保将更新之后的 package.json 文件提交到项目仓库中。
Gruntfile.js 或 Gruntfile.coffee 文件是有效的 JavaScript 或 CoffeeScript 文件,应当放在你的项目根目录中,和package.json文件在同一目录层级,并和项目源码一起加入源码管理器。
Gruntfile由以下几部分构成:
在下面列出的这个 Gruntfile 中,package.json文件中的项目元数据(metadata)被导入到 Grunt 配置中, grunt-contrib-uglify 插件中的uglify 任务(task)被配置为压缩(minify)源码文件并依据上述元数据动态生成一个文件头注释。当在命令行中执行 grunt 命令时,uglify 任务将被默认执行。
module.exports = function(grunt) { // Project configuration. grunt.initConfig({ pkg: grunt.file.readJSON("package.json"), uglify: { options: { banner: "n" }, build: { src: "src/<%= pkg.name %>.js", dest: "build/<%= pkg.name %>.min.js" } } }); // 加载包含 "uglify" 任务的插件。 grunt.loadNpmTasks("grunt-contrib-uglify"); // 默认被执行的任务列表。 grunt.registerTask("default", ["uglify"]); };
前面已经向你展示了整个 Gruntfile,接下来将详细解释其中的每一部分。
每一份 Gruntfile (和grunt插件)都遵循同样的格式,你所书写的Grunt代码必须放在此函数内:
module.exports = function(grunt) { // Do grunt-related things in here };
大部分的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文件压缩为一个目标文件。
// Project configuration. grunt.initConfig({ pkg: grunt.file.readJSON("package.json"), uglify: { options: { banner: "n" }, build: { src: "src/<%= pkg.name %>.js", dest: "build/<%= pkg.name %>.min.js" } } });
像 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", ["uglify"]);
如果Grunt插件中的任务(task)不能满足你的项目需求,你还可以在Gruntfile中自定义任务(task)。例如,在下面的 Gruntfile 中自定义了一个default 任务,并且他甚至不依赖任务配置:
module.exports = function(grunt) { // A very basic default task. grunt.registerTask("default", "Log some stuff.", function() { grunt.log.write("Logging some stuff...").ok(); }); };
特定于项目的任务不必在 Gruntfile 中定义。他们可以定义在外部.js 文件中,并通过grunt.loadTasks方法加载。
介绍Rotate3D类在x,y或z轴上围绕三维旋转目标对象。 旋转围绕目标的变换中心发生。类声明以下是 spark.effects.Rotate3D 类的声...
容器环境Kubernetes的容器环境给容器提供了几个重要的资源:文件系统,其中包含一个镜像和一个或多个的卷容器自身的信息集群中其...
Pod拓扑分布约束FEATURESTATE:Kubernetesv1.19[stable]你可以使用拓扑分布约束(TopologySpreadConstraints)来控制Pods在集群内...
CronJobCronJob用于执行周期性的动作,例如备份、报告生成等。这些任务中的每一个都应该配置为周期性重复的(例如:每天/每周/每...
拓扑感知提示FEATURESTATE:Kubernetesv1.23[beta]拓扑感知提示包含客户怎么使用服务端点的建议,从而实现了拓扑感知的路由功能。...