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://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命令。


目录
相关文章
|
Java API 数据格式
Gradle 1.12 翻译——第十六章. 使用文件
有关其他已翻译的章节请关注Github上的项目:https://github.com/msdx/gradledoc/tree/1.12,或访问:http://gradledoc.qiniudn.com/1.12/userguide/userguide.html 本文原创,转载请注明出处:http://blog.csdn.net/maosidiaoxian/article/details/41113353 关于我对Gradle的翻译,以Github上的项目及http://gradledoc.qiniudn.com 上的文档为准。
901 0
|
XML Java 测试技术
Gradle 1.12 翻译——第十五章. 任务详述
有关其他已翻译的章节请关注Github上的项目:https://github.com/msdx/gradledoc/tree/1.12,或访问:http://gradledoc.qiniudn.com/1.12/userguide/userguide.html 本文原创,转载请注明出处:http://blog.csdn.net/maosidiaoxian/article/details/41038305 关于我对Gradle的翻译,以Github上的项目及http://gradledoc.qiniudn.com 上的文档为准。
782 0
|
缓存 Java 持续交付
Gradle 1.12 翻译——第十四章. 教程 - 杂七杂八
有关其他已翻译的章节请关注Github上的项目:https://github.com/msdx/gradledoc/tree/1.12,或访问:http://gradledoc.qiniudn.com/1.12/userguide/userguide.html 本文原创,转载请注明出处:http://blog.csdn.net/maosidiaoxian/article/details/41006627 关于我对Gradle的翻译,以Github上的项目及http://gradledoc.qiniudn.com 上的文档为准。
1047 0
|
存储 Java Unix
Gradle 1.12 翻译——第十二章 使用Gradle 图形用户界面
有关其他已翻译的章节请关注Github上的项目:https://github.com/msdx/gradledoc/tree/1.12,或访问:http://gradledoc.qiniudn.com/1.12/userguide/userguide.html 本文原创,转载请注明出处:http://blog.csdn.net/maosidiaoxian/article/details/40949821 关于我对Gradle的翻译,以Github上的项目及http://gradledoc.qiniudn.com 上的文档为准。
1008 0
|
Java 测试技术
Gradle 1.12 翻译——第九章 Groovy快速入门
由于时间关系,没办法同时做笔记和翻译,关于Gradle的用户指南,本博客不再做相关笔记,而只对未翻译章节进行翻译并在此发表。 有关其他已翻译的章节请关注Github上的项目:https://github.
1115 0
|
Java 容器
翻译:Gradle之 Java插件
原文地址 http://www.gradle.org/docs/current/userguide/java_plugin.html 23.1. Usage用法 要使用Java插件,在脚本里加入: Example 23.1. Using the Java plugin build.gradle apply plugin: 'java' 23.2. Source sets源集 Java插件引入了一个概念:源集(source set),一个源集就是一组被一起编译一起执行的源文件。
774 0
|
Java API
翻译:Gradle之构建脚本编写
原文地址 http://www.gradle.org/docs/current/userguide/writing_build_scripts.html 13.1. The Gradle build language构建语言 Gradle提供了一种“领域专用语言”(domain specific language) 或者 DSL对构建进行描述。
927 0
|
Java 数据库连接 Maven
翻译:Gradle之依赖管理
  原文地址 http://www.gradle.org/docs/current/userguide/artifact_dependencies_tutorial.html   8.1. What is dependency management?何谓?为何? 依赖管理大致有两块:首先Gradle需要找到你工程需要的东西,这些东西就是所谓的“依赖”。
796 0
|
API
翻译:Gradle之构建脚本入门
原文地址http://www.gradle.org/docs/current/userguide/tutorial_using_tasks.html 6.1. Projects and tasks工程和任务 Gradle中的任何东西都基于俩概念: projects 工程 和 tasks 任务。
819 0
|
Java 测试技术 API
翻译--Gradle之Java工程入门
原文地址 http://www.gradle.org/docs/current/userguide/tutorial_java_projects.html   7.1. The Java plugin插件 我们已经看到Gradle是一个通用构建工具,它可以完成相当多的任务,只要你能在脚本里定义好。
1226 0