Gradle用户指南(3)-构建Java项目

1.构建基本的Java项目

build.gradle

    apply plugin: ‘java‘

这个就是 定义一个 Java 项目的全部。它会将 Java 插件应用到项目中，并且添加很多 task。

Gradle 会在 src/main/java 目录下寻找产品代码，在 src/test/java 寻找测试代码 。 另外在 src/main/resources 包含了资源的 JAR 文件, src/test/resources 包含了运行测试。所有的输出都在 build 目录下，JAR 在 build/libs 目录下。

PS:一些常用的task

clean

删除 build 目录，移除所有构建的文件

assemble

编译打包代码,但不运行单元测试。其他插件带给这个 task 更多特性，比如如果你使用 War 插件，task 将给 project 构建 WAR 文件

check

编译测试你的代码。其他插件带给这个 task 提供更多检查类型。比如，你使用 checkstyle 插件, 这个 task 建辉在你的代码中 执行 Checkstyle

2.依赖外部jar文件

build.gradle

    repositories {
        mavenCentral()
    }

我们添加一些依赖，声明了 编译时 需要的依赖和测试时需要的依赖

build.gradle

    dependencies {
        compile group: ‘commons-collections‘, name: ‘commons-collections‘, version: ‘3.2‘
        testCompile group: ‘junit‘, name: ‘junit‘, version: ‘4.+‘
    }

3.自定义项目属性

build.gradle

    sourceCompatibility = 1.5
    version = ‘1.0‘
    jar {
        manifest {
            attributes ‘Implementation-Title‘: ‘Gradle Quickstart‘,
                       ‘Implementation-Version‘: version
        }
    }

4.发布jar文件

build.gradle

    uploadArchives {
        repositories {
           flatDir {
               dirs ‘repos‘
           }
        }
    }

执行 gradle uploadArchives 来发布

5.创建eclipse项目

build.gradle

    apply plugin: ‘eclipse‘

执行 gradle eclipse 来生产 Eclipse project 文件。

总结

下面是完整的示例 build 文件

build.gradle

    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‘
           }
        }
    }

6.构建多个java项目

 multiproject/
      api/
      services/webservice/
      shared/
      services/shared/

里面包含 4 个 project。 api 是产生出 JAR 文件 给客户端加载提供给 Java 客户端需要的 XML webservice。webservice 是一个 web 应用返回 XML 。shared 包含了 api、webservice 使用的代码。项目 services/shared 包含了 依赖 shared 的代码。

定义 build 文件

配置文件的名字叫 settings.gradle，如下

settings.gradle

    include "shared", "api", "services:webservice", "services:shared"

常见配置

有很多常见的配置。我们的示例中使用了 configuration injection （配置注入）。在这里，根项目就像一个容器，subprojects 方法遍历容器中的元素（实例中的 project ），并将指定的配置。这样我们可以很容易地定义所有档案的 manifest 的内容，和一些常见的依赖关系：

build.gradle

    subprojects {
        apply plugin: ‘java‘
        apply plugin: ‘eclipse-wtp‘

        repositories {
           mavenCentral()
        }

        dependencies {
            testCompile ‘junit:junit:4.11‘
        }

        version = ‘1.0‘

        jar {
            manifest.attributes provider: ‘gradle‘
        }
    }

注意，示例中 在 所有 子 project 中应用了 Java 插件。意思是 task 和配置属性将会出现在虽偶有 子 project 中。所以，你可以 在根 project 目录中，运行 gradle build 来编译、测试、将所有 project 打包成 JAR 。

注意，插件只应用在 subprojects 包含的区域，其他根级别的将不适用。

7.依赖外部项目

api/build.gradle

    dependencies {
        compile project(‘:shared‘)
    }

8.创建发布包

api/build.gradle

    task dist(type: Zip) {
        dependsOn spiJar
        from ‘src/dist‘
        into(‘libs‘) {
            from spiJar.archivePath
            from configurations.runtime
        }
    }

    artifacts {
       archives dist
    }