一、多项目构建
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'
repositories{
()
}
dependencies{
testCompile'junit:junit:4.11'
}
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{
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: