一、多项目构建
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、配置根项目
我们可以通过以下步骤，对包含在多项目构建中的项目进行配置：
- 在根项目的根目录下创建
settings.gradle文件，一个多项目Gradle构建必须含有这个文件，因为它指明了那些包含在多项目构建中的项目。 - 确保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'
3.4、配置app子项目
在配置app项目之前，我们先来快速浏览一下对一些特殊依赖的依赖管理，这些依赖都是同一个多项目构建的一部分，我们将其称之为”项目依赖“。
如果多项目构建拥有项目A和B，同时，项目B的编译需要项目A，我们可以通过在项目B的build.gradle文件中添加以下依赖声明来进行依赖配置。
dependencies{
compile project('A')
}
现在，我们可以按照以下步骤配置app项目：
- 在app项目的根目录下创建build.gradle文件。
- 用Java插件创建一个Java项目。
- 确保app项目从Maven2*仓库(central Maven2 repository)中获取依赖。
- 配置所需的依赖，app项目在编译时需要两个依赖：Log4j (version 1.2.17)和
core模块 - 创建二进制发布版本
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 {
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：
