gradle构建项目之java插件

Gradle是一个通用的构建工具，通过它的构建脚本你可以构建任何你想要实现的东西，不过前提是你需要先写好构建脚本的代码。而大部分的项目，它们的构建流程基本是一样的，我们不必为每一个工程都编写它的构建代码，因为Gradle已经为我们提供了相应的插件。Gradle 本身自带了许多插件，而对于Gradle没有的插件，可以去github上看看有没有其他人实现，或自己实现。对Java项目而言，Gradle有Java插件，提供了像编译、测试、打包之类的功能。这里简单介绍一下Java插件。Java插件为构建项目定义了许多的默认设置，像源文件目录，编译后的文件存放位置等等。如果你是按着默认的规则来的，那么构建脚本将会很简单。当然，如果项目结构不一样，也可以自己指定这些规则。这里暂不介绍，只说一下基本的用法。1. 使用Java插件只需要要构建脚本中添加以下代码：[plain] view plain copy 在CODE上查看代码片派生到我的代码片apply plugin: 'java' 定义一个Java项目只需要添加这么一句代码，它会为你添加Java插件，以及一些内置任务。默认情况下，Gradle会在src/main/java中查找你的源码，在src/test/java中查找你的测试代码，而src/main/resources下的文件都会被打包，src/test/resources下的文件会被包含在classpath中用于测试。所有输出的文件都保存在build目录里，而生成的jar包则是在build/libs里面。2. 构建项目Java插件帮你定义了许多任务，这个可以通过前面说的gradle tasks命令来看。当执行gradle build 时，Gradle会执行编译，测试，并且将源文件和资源文件打成jar包。除了build之外，还有几个常用的任务，如下：clean：删除build目录和其他构建时生成的文件。assemble：编译并打包，但不执行单元测试。不过一些其他插件可能会增强这个任务，例如 War 插件会再打出war包。check：编译并测试代码。其他插件可能会增强这个任务。比如 Code-quality 插件会让这个任务去执行Checkstyle。3. 外部依赖通常一个项目会有许多外部依赖，我们需要在构建脚本中告诉Gradle在哪里可以找到这些依赖。比如如果使用maven中央仓库的话，我们可以通过以下代码来添加仓库：[plain] view plain copy 在CODE上查看代码片派生到我的代码片repositories { mavenCentral() } 然后再通过下面代码添加依赖：[plain] view plain copy 在CODE上查看代码片派生到我的代码片dependencies { compile group: 'commons-collections', name: 'commons-collections', version: '3.2' testCompile group: 'junit', name: 'junit', version: '4.+' } 上面的代码中，声明了在编译期，需要依赖 commons-collections，在测试期需要依赖 junit。关于依赖的内容，下一篇会有更详细的笔记。4. 自定义项目前面提到，Java插件为项目定义了许多默认配置，如果我们需要，这些配置都是可以由我们自己来定义的。如下面例子，指定项目版本号和JDK版本号，并且添加一些属性到JAR包的manifest文件中：[plain] view plain copy 在CODE上查看代码片派生到我的代码片sourceCompatibility = 1.5 version = '1.0' jar { manifest { attributes 'Implementation-Title': 'Gradle Quickstart', 'Implementation-Version': version } } Java插件添加的都是普通任务，所以前面一章介绍的Gradle机制也可以用在这里，比如修改任务的依赖，添加任务行为，甚至重写某个任务等等。下面的例子是修改test任务来添加系统属性：[plain] view plain copy 在CODE上查看代码片派生到我的代码片test { systemProperties 'property': 'value' } 5. 发布JAR包以下代码是发布JAR包到本地中。发布到maven仓库或jcenter仓库以后再讨论。[plain] view plain copy 在CODE上查看代码片派生到我的代码片uploadArchives { repositories { flatDir { dirs 'repos' } } } 执行gradle uploadArchives即可发布该JAR包。6. 创建Eclipse项目如果想把项目导入到eclipse当中，需要使用一个Eclipse插件：[plain] view plain copy 在CODE上查看代码片派生到我的代码片apply plugin: 'eclipse' 执行gradle eclipse会生成eclipse项目文件，关于此插件以后再细说。7. 小结下面是一个完整的Java项目构建脚本：[plain] view plain copy 在CODE上查看代码片派生到我的代码片apply plugin: 'java' apply plugin: 'eclipse' sourceCompatibility = 1.5 version = '1.0' jar { manifest { attributes 'Implementation-Title': 'Gradle Quickstart', 'Implementation-Version': version } } repositories { mavenCentral() } dependencies { compile group: 'commons-collections', name: 'commons-collections', version: '3.2' testCompile group: 'junit', name: 'junit', version: '4.+' } test { systemProperties 'property': 'value' } uploadArchives { repositories { flatDir { dirs 'repos' } } } 8. 多项目构建项目结构：[plain] view plain copy 在CODE上查看代码片派生到我的代码片multiproject/ api/ services/webservice/ shared/ 首先需要创建一个settings.gradle的配置文件，来声明构建要包含哪些项目。文件的内容如下：[plain] view plain copy 在CODE上查看代码片派生到我的代码片include "shared", "api", "services:webservice", "services:shared" 多项目构建，以后会详谈。9. 公共配置对多项目构建当中，会有一些配置是共同的。Gradle会在根项目上采用一种叫配置注入的方式定义一些公共配置。所以在这种情况下，可以把这些公共配置定义在根项目的配置文件里，子项目的配置文件会迭代这些配置并注入到自己的配置中。下面是示例代码：[plain] view plain copy 在CODE上查看代码片派生到我的代码片subprojects { apply plugin: 'java' apply plugin: 'eclipse-wtp' repositories { mavenCentral() } dependencies { testCompile 'junit:junit:4.11' } version = '1.0' jar { manifest.attributes provider: 'gradle' } } 上面的配置就会子项目都应用了java和eclipse-wtp插件，声明了maven中央仓库，添加了测试期的依赖junit，以及定义了项目版本包和打成的jar包里的manifest文件的属性。10. 项目依赖同一个构建中的项目可以建立项目依赖。比如api子项目要依赖share子项目生成的jar包，那么在api子项目的构建脚本中可以使用以下代码：[plain] view plain copy 在CODE上查看代码片派生到我的代码片dependencies { compile project(':shared') } 11. 多项目的打包发布[plain] view plain copy 在CODE上查看代码片派生到我的代码片task dist(type: Zip) { dependsOn spiJar from 'src/dist' into('libs') { from spiJar.archivePath from configurations.runtime } } artifacts { archives dist } 这段代码我还没能理解。先记着。下篇将是Gradle依赖管理基础的笔记。本系列博客为Gradle 用户手册的笔记。本文是Gradle 1.2的第七章Java构建快速入门的笔记，博客中的代码均来源于此文档。本文原创，转载请注明出处：http://blog.csdn.net/maosidiaoxian/article/details/40656311。