gradle入门(1-4)多项目构建实战

一、多项目构建

1、多项目构建概念

尽管我们可以仅使用单个组件来创建可工作的应用程序,但有时候更广泛的做法是将应用程序划分为多个更小的模块。

因为这是一个非常普遍的需求,因此每个成熟的构建工具都必须支持这项功能,Gradle也不例外。

如果Gradle项目拥有多于一个组件,我们就称之为多项目构建(multi-project build)。

2、多项目构建的需求描述

我们的例子拥有两个模块:

2.1、core模块:

包含一些通用的组件,它们能够被程序的其他模块使用。

在我们的例子上,只包含一个类:MessageService类返回‘Hello World!’字符串。

该模块只有一个依赖:它包含一个单元测试,使用Junit 4.11。

2.2、app模块:

包含HelloWorld类,是程序的开端,

它从MessageService对象中获取信息,并将接收到的信息写入一个日志文件中。

该模块拥有两个依赖:它需要core模块,还使用Log4j 1.2.17作为日志库。

3、建立多项目的gradle工程

下面我们将创建一个多项目的Gradle构建,包括两个子项目:app 和 core。

3.1、建立目录结构

初始阶段,先要建立Gradle构建的目录结构。

建立core模块的根目录(core),并建立以下子目录:

src/main/java目录包含core模块的源代码。

src/test/java目录包含core模块的单元测试。

建立app模块的根目录(app),并建立以下子目录:

src/main/java目录包含app模块的源代码。

src/main/resources目录包含app模块的资源文件。

3.2、配置根项目

我们可以通过以下步骤,对包含在多项目构建中的项目进行配置:

  1. 在根项目的根目录下创建settings.gradle文件,一个多项目Gradle构建必须含有这个文件,因为它指明了那些包含在多项目构建中的项目。
  2. 确保app和core项目包含在我们的多项目构建中。

我们的settings.gradle文件如下:

include 'app'

include 'core'

3.3、配置core子项目 

我们可以通过以下步骤对core项目进行配置:

  • 1. 在core项目的根目录下创建build.gradle文件。
  • 2. 使用Java插件创建一个Java项目。
  • 3. 确保core项目从Maven2*仓库(central Maven2 repository)中获取依赖。
  • 4. 声明JUnit依赖(版本4.11),并使用testCompile配置项,该配置项表明:core项目在它的单元测试被编译前,需要JUnit库。

core项目的build.gradle文件如下:

apply plugin: 'java' 

repositories {
    mavenCentral()
} 
dependencies {
    testCompile 'junit:junit:4.11'

3.4、配置app子项目 

在配置app项目之前,我们先来快速浏览一下对一些特殊依赖的依赖管理,这些依赖都是同一个多项目构建的一部分,我们将其称之为”项目依赖“。

如果多项目构建拥有项目A和B,同时,项目B的编译需要项目A,我们可以通过在项目B的build.gradle文件中添加以下依赖声明来进行依赖配置。

dependencies{

    compile project('A')

}

现在,我们可以按照以下步骤配置app项目:

  1. 在app项目的根目录下创建build.gradle文件。
  2. 用Java插件创建一个Java项目。
  3. 确保app项目从Maven2*仓库(central Maven2 repository)中获取依赖。
  4. 配置所需的依赖,app项目在编译时需要两个依赖:Log4j (version 1.2.17)和core 模块
  5. 创建二进制发布版本

apply plugin: 'application'

apply plugin: 'java'

repositories {
    mavenCentral()
}
dependencies {
    compile 'log4j:log4j:1.2.17'
    compile project(':core')
}
mainClassName = 'net.petrikainulainen.gradle.client.HelloWorld'
task copyLicense {
    outputs.file new File('$buildDir/LICENSE')
    doLast {
        copy {
            from 'LICENSE'
            into '$buildDir'
        }
    }
}
applicationDistribution.from(copyLicense) {
    into '';
}

二、多项目构建优化 - 移除重复配置

1、提升冗余配置到根项目

subprojects {

    apply plugin: 'java' 
    repositories {
        mavenCentral()
    }
} 
// 所有项目所共享的配置
allprojects {
    //Add configuration here
}

2、在根项目中指名配置子项目

2.1、core/build.gradle文件

dependencies{

    testCompile 'junit:junit:4.11'

}

2.2、app/build.gradle文件

apply plugin: 'application'

dependencies{

     compile 'log4j:log4j:1.2.17'

     complile project(':core')

}

mainClassName='com.inspur.example.gradle.HelloGradle'

task copyLicense {
    outputs.file new File('$buildDir/LICENSE')
    doLast {
        copy {
            from 'LICENSE'
            into '$buildDir'
        }
    }
}
applicationDistribution.from(copyLicense) {
    into '';
}

3、构建多项目 gradle projects

这条命令执行结果会列出根项目下的子项目(app和core),意味着多项目Gradle构建成功了。

三、附录

1、如何查看gradle插件提供的各种任务----->gradle tasks 

举个例子,Java插件在我们的构建中加入了很多任务,如:

  • assemble 任务会编译程序中的源代码,并打包生成Jar文件,这个任务不执行单元测试。
  • build 任务会执行一个完整的项目构建。
  • clean 任务会删除构建目录。
  • compileJava 任务会编译程序中的源代码。

如何查看这些任务呢?我们通过 gradle tasks:

gradle入门(1-4)多项目构建实战

上一篇:关于Java中子类调用父类方法


下一篇:Fiddler怎样抓取手机的包