这份文档详细解释了如何安装指定版本的 Grunt 和 Grunt 插件。如果你还没有阅读 快速入门指南,请先将其看一遍。
Grunt 和 Grunt 插件应当在项目的package.json文件中的devDependencies小节中定义。这样就可以通过一个命令将当前项目依赖的模块安装完毕:npm install
。当前 Grunt 的稳定和开发版本都会在项目的wiki页面中列出。
如果你需要某个特定版本的 Grunt 或 Grunt 插件,执行npm install grunt@VERSION --save-dev
命令,其中VERSION
代表你所需要的版本。这样就安装完成了,然后将其添加到package.json文件中的devDependencies小节中。
注意,当你在npm install
命令后面添加了--save-dev
标记之后,package.json
文件中出现的将是波浪线标记的版本范围。一般情况下这样做很不错,当指定版本发布补丁更新后,新版本将被自动升级,并且按照semver定义的语义版本格式。
随着新功能被开发出来,Grunt 会被定期的发布到npm上。如果不指定版本号,这种构建的版本是 根本不会被安装的,通常它们都会被指定构建码或 alpha/beta/release。
就像安装指定版本的 Grunt 一样,执行npm install grunt@VERSION --save-dev
命令,其中VERSION
是你指定的版本,npm将在项目目录中安装此版本的grunt,并将其添加到package.json
文件中的devDependencies小节。
注意,不管你指定的是什么版本,都将按照[波浪线标记的版本范围]将其添加到package.json
文件中。这个危害很大,当指定的开发版出现新版本,尤其是不兼容的patch版本时,也会被npm安装,这就有可能扰乱你的项目,使其无法编译。
一旦出现这种情况,最重要的是要手工编辑 package.json
文件,将 ~ (tilde)从版本号中去除掉。这样就能锁定到你所指定的某个具体的开发版本了。
这个技巧同样可以用于安装已经发布的 Grunt 插件的开发版本。
如果你需要安装最最最新的版本,而且这个 Grunt 或 Grunt 插件的版本并没有公布,按照下面的步骤来指定git URL 作为依赖并且确保指定了具体的commit SHA (not a branch name) as the commit-ish
。这将确保你的项目永远使用这个精确版本的grunt。
这个指定的git URL可以是官方的 Grunt 仓库,也可以是一个fork版本。