Gradle 1.12用户指南翻译——第二十四章. Groovy 插件
来源:互联网 发布:java.util.arraylist 编辑:程序博客网 时间:2024/04/28 16:53
其他章节的翻译请参见:
http://blog.csdn.net/column/details/gradle-translation.html
翻译项目请关注Github上的地址:
https://github.com/msdx/gradledoc/tree/1.12。
直接浏览双语版的文档请访问:
http://gradledoc.qiniudn.com/1.12/userguide/userguide.html。
另外,Android 手机用户可通过我写的一个程序浏览文档,带缓存功能的,兼容2.1以上(5.0没试过)的Android系统,地址如下:
http://www.wandoujia.com/apps/com.githang.gradledoc
翻译不易,转载请注明本文在CSDN博客上的出处:
http://blog.csdn.net/maosidiaoxian/article/details/45390357
关于我对Gradle的翻译,以Github上的项目及http://gradledoc.qiniudn.com 上的文档为准。如有发现翻译有误的地方,将首先在以上两个地方更新。因时间精力问题,博客中发表的译文基本不会同步修改。
第二十四章. Groovy 插件
Groovy 的插件继承自 Java 插件并添加了对 Groovy 项目的支持。它可以处理 Groovy 代码,以及混合的 Groovy 和 Java 代码,甚至是纯 Java 代码(尽管我们不一定推荐使用)。该插件支持联合编译,可以任意地混合及匹配Groovy 和 Java 代码各自的依赖。例如,一个 Groovy 类可以继承自一个 Java 类,而这个 Java 类也可以继承自一个 Groovy 类。这样一来,我们就能够在项目中使用最适合的语言,并且在有需要的情况下用其他的语言重写其中的任何类。
24.1. 用法
要使用 Groovy 的插件,请在构建脚本中包含以下语句:
示例 24.1. 使用 Groovy 插件
build.gradle
apply plugin: 'groovy'
24.2. 任务
Groovy 的插件向project 中添加了以下任务。
表 24.1. Groovy 插件 - 任务
compileGroovy
compileJava
GroovyCompile
编译production 的 Groovy 源文件。compileTestGroovy
compileTestJava
GroovyCompile
编译test 的 Groovy 的源文件。compileSourceSet
Groovy
compileSourceSet
Java
GroovyCompile
编译给定的source set 里的 Groovy 源文件。groovydoc
-Groovydoc
为production 里的 Groovy 源文件生成 API 文档。Groovy 的插件向 Java 插件所加入的 tasks 添加了以下的依赖。
表 24.2. Groovy 插件 - 额外的task 依赖
sourceSet
ClassescompileSourceSet
Groovy图 24.1. Groovy 插件 - tasks
24.3. 项目布局
Groovy 的插件会假定项目的布局如表 24.3,“Groovy 插件 - 项目布局”中所示。所有 Groovy 的源目录都可以包含 Groovy和Java 代码。Java 源目录只能包含 Java 源代码。[11]这些目录不一定得存在或是里面包含有什么内容;Groovy 的插件只会进行编译,而不管它发现什么。
表 24.3. Groovy 插件 - 项目布局
src/main/java
产品的Java源代码src/main/resources
产品的资源src/main/groovy
Production Groovy 源代码。此外可能包含联合编译的 Java 源代码。src/test/java
Java 测试源代码src/test/resources
测试资源src/test/groovy
Test Groovy 源代码。此外可能包含联合编译的 Java 源代码。src/sourceSet
/java
给定的源集的Java源代码src/sourceSet
/resources
给定的源集的资源src/sourceSet
/groovy
给定的source set 的 Groovy 源代码。此外可能包含联合编译的 Java 源代码。24.3.1. 更改项目布局
和 Java 插件一样,Groovy 插件允许把 Groovy 的production 和test 的源文件配置为自定义的位置。
示例 24.2. 自定义 Groovy 自定义源文件布局
build.gradle
sourceSets { main { groovy { srcDirs = ['src/groovy'] } } test { groovy { srcDirs = ['test/groovy'] } }}
24.4. 依赖管理
由于 Gradle 的构建语言基于 Groovy 的,且部分的 Groovy 使用 Groovy 实现,因此 Gradle 已经带有了一个 Groovy 库 (截至 Gradle 1.6所带的 Groovy 库的版本是 1.8.6)。然而,Groovy 项目需要显式地声明一个 Groovy 依赖。这个依赖会在编译和运行的类路径时用到。它还将用于分别获取Groovy 编译器及 Groovydoc 工具。
如果 Groovy 用于production 代码,Groovy 依赖应该添加到compile
配置中:
示例 24.3. Groovy 的依赖配置
build.gradle
repositories { mavenCentral()}dependencies { compile 'org.codehaus.groovy:groovy-all:2.2.0'}
如果 Groovy 仅用于测试代码,Groovy 的依赖应该被添加到testCompile
配置中:
示例 24.4. 配置Groovy 测试依赖
build.gradle
dependencies { testCompile "org.codehaus.groovy:groovy-all:2.2.0"}
如果要使用 Gradle 所带的 Groovy 库,请声明localGroovy()
依赖。注意,不同 Gradle 版本附带的 Groovy 版本不同;因此,声明一个固定的 Groovy 依赖要比使用localGroovy()
更安全一些。
示例 24.5. 配置捆绑的 Groovy 依赖
build.gradle
dependencies { compile localGroovy()}
Groovy 库不一定得从远程仓库中获取。它也可以获取自本地中可能检入版本控制的lib
目录:
示例 24.6. 配置Groovy 文件依赖
build.gradle
repositories { flatDir { dirs 'lib' }}dependencies { compile module('org.codehaus.groovy:groovy:1.6.0') { dependency('asm:asm-all:2.2.3') dependency('antlr:antlr:2.7.7') dependency('commons-cli:commons-cli:1.2') module('org.apache.ant:ant:1.9.3') { dependencies('org.apache.ant:ant-junit:1.9.3@jar', 'org.apache.ant:ant-launcher:1.9.3') } }}
24.5. groovyClasspath 的自动配置
GroovyCompile
和Groovydoc
tasks 会以两种方式使用 Groovy: 在它们的classpath
以及它们的groovyClasspath
上。前者用于在源代码中查找类的引用,通常会包含 Groovy 库和其他库。后者用来分别加载和执行 Groovy 编译器和 Groovydoc 工具,并且应该只包含 Groovy 库及其依赖项。
除非显式配置了一个 task 的groovyClasspath
,否则 Groovy(基础)插件会尝试推断该 task 的classpath
。以如下方式进行:
- 如果在在
classpath
中找到groovy-all(-indy)
Jar,相同的 Jar 将添加到groovyClasspath
中。 - 如果在
classpath
中找到groovy(-indy)
Jar ,并且该项目已经在至少一个仓库中声明了它,那么相应的groovy(-indy)
的仓库依赖将添加到groovyClasspath
中。 - 其他情况,该task 将执行失败,并提示无法推断
groovyClasspath
。
24.6. 常规属性
Groovy 的插件没有向 project 添加任何的常规属性。
24.7. source set 属性
Groovy 的插件向 project 的每一个source set 添加了下列的常规属性。你可以在你的构建脚本中,把这些属性当成是source set 对象中的属性一样使用 (见第 21.3,“公约”)。
表 24.4. Groovy 插件 - source set 属性
groovy
SourceDirectorySet
(read-only)非空该source set 中的 Groovy 源文件。包含在 Groovy 源目录中找到的所有的.groovy
和.java
文件,并排除所有其他类型的文件。groovy.srcDirs
Set<File>
. 可以使用 16.5 章节,"指定一组输入文件"中所讲到的任何一个来设置。[projectDir
/src/name
/groovy]
源目录包含该 source set 中的 Groovy 源文件。此外可能还包含用于联合编译的 Java 源文件。allGroovy
FileTree
(read-only)非空该source set 中的所有 Groovy 源文件。包含在 Groovy 源目录中找到的所有的.groovy
文件。这些属性由一个GroovySourceSet
的约定对象提供。
Groovy 的插件还修改了一些 source set 的属性:
表 24.5. Groovy 的插件 - source set 属性
allJava
添加在 Groovy 源目录中找到的所有.java
文件。allSource
添加在 Groovy 的源目录中找到的所有源文件。24.8. GroovyCompile
Java 插件向 project 里的每个source set 添加了一个JavaCompile
task。这个task 的类型继承自JavaCompile
task(见第 23.11 节,“CompileJava”)。除非groovyOptions.useAnt
设置为true
,否则将使用 Gradle 集成的本地的 Groovy 编译器。对于大多数项目而言,这相比基于 Ant 编译器,是个更好的选择。GroovyCompile
task 支持官方的 Groovy 编译器的大多数配置选项。
表 24.6. Groovy 插件 - GroovyCompile 属性
classpath
FileCollection
sourceSet
.compileClasspath
source
FileTree
. 可以使用 16.5 章节,"指定一组输入文件"中所讲到的任何一种方式来设置。sourceSet
.groovy
destinationDir
File
.sourceSet
.output.classesDir
groovyClasspath
FileCollection
如果groovy
配置不为空,则为该配置;否则为 classpath
中找到的 Groovy 库[11] 我们使用和 Russel Winder 的 Gant 工具同样的约定(http://gant.codehaus.org)。
- Gradle 1.12用户指南翻译——第二十四章. Groovy 插件
- Gradle 1.12用户指南翻译——第三十四章. JaCoCo 插件
- Gradle 1.12用户指南翻译——第四十四章. 分发插件
- Gradle 1.12用户指南翻译——第二十一章. Gradle 插件
- Gradle 1.12用户指南翻译——第二十五章. Scala 插件
- Gradle 1.12用户指南翻译——第二十六章. War 插件
- Gradle 1.12用户指南翻译——第二十七章. Ear 插件
- Gradle 1.12用户指南翻译——第二十八章. Jetty 插件
- Gradle 1.12用户指南翻译——第二十九章. Checkstyle 插件
- Gradle 1.12用户指南翻译——第二十三章. Java 插件
- Gradle 1.12用户指南翻译——第三十章. CodeNarc 插件
- Gradle 1.12用户指南翻译——第四十章. ANTLR 插件
- Gradle 1.12用户指南翻译——第五十四章. 构建原生二进制文件
- Gradle 1.12用户指南翻译——第六十四章. 发布到Ivy(新)
- Gradle 1.12用户指南翻译——第二十二章. 标准的 Gradle 插件
- Gradle 1.12用户指南翻译——第三十一章. FindBugs 插件
- Gradle 1.12用户指南翻译——第三十二章. JDepend 插件
- Gradle 1.12用户指南翻译——第三十三章. PMD 插件
- PHP裁剪图片插件记录
- Caffe+Ubuntu 14.04 + Cuda6.5 新手安装记录
- 获取以太网子网掩码
- 状态压缩dp 最优配对问题
- 关于vc6.0各种新建工程的含义
- Gradle 1.12用户指南翻译——第二十四章. Groovy 插件
- Android ramdisk.img system.img userdata.img介绍与使用
- 服务器监控工具zabbix、nagios、ganglia
- Java图片处理开源框架
- Lisp的前世今生
- hdu2035 人见人爱A^B(快速幂取模)
- Sort an array alphabetically in Ruby but with capitalised words at the end
- Android 编程下通过 Theme 和 Style 避免 APP 启动闪黑屏
- 记天溯实习期间关于mondrian的开发小结