Gradle 1.12用户指南翻译——第六十一章. Gradle包装器

其他章节的翻译请参见：
http://blog.csdn.net/column/details/gradle-translation.html
翻译项目请关注Github上的地址：
https://github.com/msdx/gradledoc
本文翻译所在分支：
https://github.com/msdx/gradledoc/tree/1.12。
直接浏览双语版的文档请访问：
http://gradledoc.qiniudn.com/1.12/userguide/userguide.html。
另外，Android 手机用户可通过我写的一个程序浏览文档，带缓存功能的，目前0.6开发中版本兼容 Android 2.3以上系统，项目地址如下：
https://github.com/msdx/gradle-doc-apk
翻译不易，转载请注明本文在CSDN博客上的出处：

http://blog.csdn.net/maosidiaoxian/article/details/70971200

关于我对Gradle的翻译，以Github上的项目及http://gradledoc.qiniudn.com 上的文档为准。如发现翻译有误的地方，将首先在以上两个地方更新。因时间精力问题，博客中发表的译文基本不会同步修改。

另外，目前Gradle1.12版本的文档已经翻译完并进入校稿阶段，校稿的方式为到该项目https://github.com/msdx/gradledoc 提交issue或是pull request。校稿的结果不只是在此版本更新，也会用于改善Gradle下一版本（2.0）文档的翻译。

第六十一章. Gradle包装器

Gradle 包装器（下称“包装器”）是启动 Gradle 构建的首选方法。这个包装器是Windows上的一个批处理脚本和以及用于其他操作系统的shell 脚本。当你通过包装器启动 Gradle 构建时，Gradle 将被自动下载并用于运行这个构建。

The wrapper is something you should check into version control. By distributing the wrapper with your project, anyone can work with it without needing to install Gradle beforehand. 甚至还有更好的效果，能保证用户在构建中所使用的Gradle版本一致。当然，也方便用于 持续集成 服务器（即有规律地构建你的项目的服务器），因为它不需要在服务器上进行配置。

你可以通过在你的构建脚本中添加及配置一个 Wrapper 任务，然后执行它来把包装器安装到你的项目中。

示例 61.1。 Wrapper任务

build.gradle

task wrapper(type: Wrapper) {    gradleVersion = '1.4'}

在这样执行之后，你会在你的项目目录中发现以下新生成的或更新的文件（在所使用的wrapper任务为默认配置的情况下）。

示例 61.2. 包装器生成的文件

构建布局

simple/  gradlew  gradlew.bat  gradle/wrapper/    gradle-wrapper.jar    gradle-wrapper.properties

所有这些文件都应该 被提交到你的版本控制系统中。这只需要做一次。在这些文件都已经被添加到项目中之后，这个项目以后应该使用所添加的 gradlew命令进行构建。这个gradlew 命令可以和 gradle 命令 完全 一样地使用。

如果你想要切换到一个新的Gradle版本，你不需要重新运行wrapper任务。只需要修改gradle wrapper.properties文件中的相应属性就够了。但如果有例如gradle包装器功能的提升的话，你还是需要重新生成包装器的文件。

61.1. 配置

如果你使用gradlew运行Gradle，包装器会检查所要使用的Gradle分发包是否可用。如果不可用，它会试图下载它，可用的话它将把所有传入给gradlew 命令的参数都委托给这个分发包的gradle 命令行。

当你配置Wrapper任务时，你可以指定你想要使用的 Gradle 版本。 gradlew命令将从 Gradle 仓库下载适合的分发包。或者，你可以指定Gradle分发包的下载URL。 gradlew 命令将使用此URL来下载分发包。如果你对 Gradle 版本和下载 URL都没有指定， gradlew命令将默认下载之前生成包装器的文件的Gradle版本。

有关如何配置包装器的详细信息，请参见Wrapper。

如果你不想在通过 gradlew命令构建项目时去下载它的分发包，只需要将Gradle分发包的zip文件添加到你的版本控制中你的包装器配置所指定的位置。它支持相对路径URL——你可以指定相对于gradle wrapper.properties文件的位置的分发文件。

如果你通过包装器构建，这台机器上已安装的任何Gradle分发包都会被忽略。

61.2. Unix 文件权限

Wrapper 任务将添加相应的文件权限，以允许执行 gradlew *NIX 命令。Subversion 会保留此文件的权限。我们并不确定其他的版本控制系统是怎么处理的。所以能让它总是可以执行的方法是执行sh gradlew命令。