NO END FOR LEARNING

Writing blog if you feel tired | 学海无涯 苦写博客

Gradle深入与实战(二)Java插件

| Comments

没有介绍Gradle的基础知识,直接开始实战,目的是为了更快的让大家开始使用Gradle做构建,快速上手,当需要实现的自动化需求更复杂时,在深入学习基础知识。

这一篇,我们直接开始Java插件的使用。

应用Java插件

Gradle是一个通用构建工具,也就是说,它不单是为Java而生。比如,还可以做Groovy,Scala的构建。这取决于你使用什么样的插件。

大部分Java项目的基本步骤都非常类似,编译Java源代码,运行单元测试,拷贝生成的class文件到目标目录,打包Jar文件(或者War包,Ear包),而这些重复且约定俗成的任务,如果可以不用写一行构建代码就实现,是多么的棒!Maven就做到这一点,采用约定由于配置的思想,预先定义常用的任务,并定义它们的执行顺序。

Gradle吸收了Maven的这个优点,通过插件,实现预定义任务和任务之间依赖关系的导入,这样就可以在一行代码都不写的情况下(如果应用插件,你觉得也算一行的话,那就写一行吧),直接使用已经定义的任务。

1
apply plugin: 'java'

SourceSet和项目布局

就和Maven一样,在默认的情况下,项目的目录结构是固定的Java世界的标准项目目录布局,只不过Maven的不可以改,但是Gradle可以改。

1
2
3
4
5
6
7
8
9
10
src {//目录结构而已,不是代码
   main {
       java
       resources
   }
   test {
       java
       resources
   }
}

Java插件引入了一个概念叫做SourceSets,它代表了一组源文件,通过修改SourceSets中的属性,可以指定哪些源文件(或文件夹下的源文件)要被编译,哪些源文件要被排除。Gradle就是通过它实现Java项目的布局定义。

Java插件默认实现了两个SourceSet,main和test。每个SourceSet都提供了一系列的属性,通过这些属性,可以定义该SourceSet所包含的源文件。比如,java.srcDirs,resources.srcDirs。Java插件中定义的其他任务,就根据main和test的这两个SourceSet的定义来寻找产品代码和测试代码等。

在构建脚本中,怎么样定义或者修改SourceSet呢?Gradle提供了一系列的DSL,可以让你方便的定义或者修改配置。比如,sourceSets的DSL。

1
2
3
4
5
6
7
8
9
10
sourceSets {
    main {
        java {
            srcDir 'src/java'
        }
        resources {
            srcDir 'src/resources'
        }
    }
}

上面的这个例子,在sourceSets中,修改了Java插件中已经定义的SourceSet main,修改了它的java.srcDir和resources.srcDir。于是,项目的目录结构就改变了。

改变Java插件中预定义的项目目录结构,不是我们最终的目的,因为它是目前Java世界,标准的项目布局,或者说大家都遵守的项目布局。

sourceSets最主要的作用是增加新的目录约定,比如,你想要定义一个新的SourceSet来管理集成测试的源文件,这样可以将单元测试和集成测试分开管理。

至于,关于具体如何为集成测试写一个新的SourceSet会在后面介绍依赖管理时举例说明。

Java插件提供的任务

Java插件提供了一系列的任务给你使用,包括编译,运行测试,打包等等。当你在项目中应用Java插件时,就已经将这些任务集成到你的项目中了。

在命令行中,运行gradle tasks命令,可以查看当前项目下主要的task。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
Build tasks
assemble - Assembles the outputs of this project.
build - Assembles and tests this project.
buildDependents - Assembles and tests this project and all projects that depend on it.
buildNeeded - Assembles and tests this project and all projects it depends on.
clean - Deletes the build directory.
jar - Assembles a jar archive containing the main classes.

Documentation tasks
javadoc - Generates Javadoc API documentation for the main source code.

Verification tasks
check - Runs all checks.
test - Runs the unit tests.

你可以对比Java插件应用前和应用后该命令的输出,Java插件提供的任务有很多,至于每个任务是做什么,这里就不赘述了。

Java插件除了为你预定义这些任务,该预定义了这些任务之间的依赖关系。如下图:

你也可以通过命令gradle tasks –all来查看每个task各自有什么依赖。

当然,这里还是重点提下,Java插件中四个重要和常用的任务,assemble,check,build,clean。

assemble
All archive tasks in the project, including jar. Some plugins add additional archive tasks to the project.
check
All verification tasks in the project, including test. Some plugins add additional verification tasks to the project.
build
check and assemble
clean
Deletes the project build directory.

assemble被用来产生Jar文件,输出目录在build/libs下。

check用来运行所有的验收任务,包括test任务,以及其他验收任务,比如checkstyle。

Tips:在命令行中运行单个测试

JAVA插件中的test任务提供了一个filter属性,可以帮助指定运行test任务时,什么测试源文件要包含,什么要排除。

1
2
3
4
5
6
7
8
9
10
11
12
test {
    filter {
        //include specific method in any of the tests
        includeTestsMatching "*UiCheck"

        //include all tests from package
        includeTestsMatching "org.gradle.internal.*"

        //include all integration tests
        includeTestsMatching "*IntegTest"
    }
}

当然一般情况下,你不会这么去做。

但重点是,你可以通过命令行传递的参数来指定这个matching规则,这样你就可以通过命令行来指定跑某一类测试,或者单个测试。你一定遇到过,某个测试在命令行中可以运行,在IDE中不能运行,或者反过来。这时,你可以不会想要跑全部的测试来验证某一个测试。于是,你就可以通过命令行来运行某一个测试:

1
2
gradle test --tests org.gradle.SomeTest.someSpecificFeature
gradle test --tests *IntegTest

到目前为止,你已经了解了Java插件提供的一些核心功能和有用小技巧。虽然还未涉及到Jar任务和uploadfile任务(这些任务当需要时,再去看就行了),但是就启动项目而言,对Java插件的使用所需要了解的知识已经足够了。

下一节,讲解依赖管理

参考资料:
1.Gradle官方文档

Gradle深入与实战(一)什么是构建工具

| Comments

什么是构建工具?

一个可编程的工具,能够以可执行和有序的任务来表达满足需要的自动化过程。

以Java为例,要得到一个简单可运行的Jar文件,需要下面几步:

1.编译源代码
2.运行测试(前提是你有测试) 3.拷贝Class文件到目标目录
4.打包Class文件为Jar文件

这是一个完整的可自动化的过程,在没有构建工具之前,是由谁来做?IDE。一个强大的IDE,以上的步骤都只需要按几个按钮,这让开发人员的生活变得很美好,完全集中在写出优秀的代码。

现在,本来整个开发过程只需要你一个人,随着任务的难度和复杂度的加剧,你的团队从一个人变成了3个人或者更多。这时,你肯定会需要代码集成,这个问题好解决,使用版本控制,无论是中心式的SVN还是分布式的Git,总之可以既可以解决版本问题,也解决代码集成的问题。

这种情况下,在没有自动化构建时,你肯定会遇到下面几个问题:
1.在我的机器上可以跑
2.从版本控制check out代码,发现编译不过,有人少提交了代码文件
3.有个人提交代码时没跑测试,导致其他人check out代码后,测试跑不过
4.版本发布时,由一个人来check out所有代码,在他自己的机器上编译打包,结果部署到服务器上运行不了

导致上面这些问题出现的原因都有两个特点:
1.手动介入
2.重复任务

开发人员要关注的应该是编写实现功能的代码,至于编译编译代码,拷贝文件,运行测试等一切重复和可自动化的事情都应该交给机器去做,因为人是容易犯错的。

Java世界的构建工具

在Java的世界里,目前在被使用的常用构建工具有三个:Ant,Maven,Gradle。

Ant的核心是由Java编写,采用XML作为构建脚本,这样就允许你在任何环境下,运行构建。Ant基于任务链思想,任务之间定义依赖,形成先后顺序。缺点是使用XML定义构建脚本,导致脚本臃肿,Ant自身没有为项目构建提供指导,导致每个build脚本都不一样,开发人员对于每个项目都需要去熟悉脚本内容,没有提供在Ant生态环境内的依赖管理工具。

Maven团队意识到Ant的缺陷,采用标准的项目布局,和统一的生命周期,采用约定由于配置的思想,减少构建脚本需要的编写内容,活跃的社区,可以方便找到合适的插件,强大的依赖管理工具。缺点是采用默认的结构和生命周期,太过限制,编写插件扩展麻烦,XML作为构建脚本。

如果有一个构建工具可以折中,同时拥有Ant和Maven的优点,是不是很爽?告诉你有,那就是Gradle。

Gradle

基于Groovy的DSL,提供声明式的构建语言
采用标准的项目布局,但拥有完全的可配置性,就是可以改
通过插件,提供默认的构建生命周期,也可以自己定义任务,单独运行任务,定义任务间的依赖
强大的依赖管理工具,与Maven和Ivy仓库结合
与Ant天生兼容,有效的重用Ant的任务
多种实现插件的方式,强大的官方插件库
从构建级别,支持从Ant或者Maven的逐步迁移
通过包装器,无缝的在各个平台运行

看一个超级简单的例子:

如果你的项目采用标准的Maven布局(Java世界的标准布局)

1
2
3
4
5
6
7
8
9
10
src {//目录结构而已,不是代码
   main {
       java
       resources
   }
   test {
       java
       resources
   }
}

在项目根目录下,创建一个build.gradle,这个是Gradle的构建脚本文件,就和build.xml,POM.xml道理一样。

那么你要实现Java的编译,测试,拷贝class到目标目录,打包Jar文件等,只需要在构建脚本中,使用下面一句话,使用Java插件。

1
apply plugin: 'java'

然后运行gradle build。

下一篇,我们深入到实战学习Java插件的使用和依赖管理,让你快速开始Java应用开发。

参考资料:
1. 《Gradle in Action》Gradle实战