1、背景介绍

Gradle 是基于 JVM 的构建工具，是基于 Ant 、Maven、ivy 概念的一款通用灵活的构建工具，基于 Groovy 脚本构建，目前支持 Java、Groovy、Kotlin 和 Scala 语言，能够满足日常开发中复杂构建需求的开源工具。

好了，介绍了那么多Gradle，切入正题。最近一直在研究 Gradle 的使用配置，感觉 Gradle 对比下 Maven 还是挺好用的，刚好公司有项目组开始尝试 Maven 转 Gradle，碰到的第一个难题就如标题了。 对于 Muti-project 项目，Gradle 也提供了很好的支持，通过配置 allprojects 和 subprojects 能够很好的在父项目与子模块之间中配置依赖和继承。但是，对于多个 Muti-project 都需要依赖某些插件的时候，在用这种方式就不友好了，我们会想起 Maven 工程中 Parent 继承父 POM 的方式，就可以把一些通用的插件配置集中配置，其他项目使用，直接 Parent 指定 POM 版本方式，就可以直接继承使用，岂不是很方便。。。

仔细扒了下 Gradle 官方文档，以及 Google 类似问题，多数提供的解决方案是自定义插件，虽然说通过 Gradle 自定义插件可以实现，但是对于我们要在通用插件中还需要使用别人写好的插件的时候，或者说别人插件并不能完全满足需求，我们还需要在此基础上做一些扩展 Task 的时候，这个自定义插件就不是那么简单的写出来了。 我们需要的是 在 common.gradle 中直接定义使用别人的插件或者在增加一些扩展 Task 来满足需求，项目需要使用的时候，直接继承 common.gradle 就能使用定义的 Task，类似 Maven Parent 继承方式。

2、环境、软件准备

本次演示环境，我是在本机 Mac OX 上操作，以下是安装的软件及版本：

1. Gradle：version 4.1
2. Java： version 1.8.0_91
3. gradle-release-plugin：2.4.0

注意：这里我们要演示下 Java Gradle 项目使用 gradle-release 插件执行 release 版本管理操作，所以需要先安装一下 Java、Gradle。Java 这里忽略安装过程。

3、Gradle 安装

Gradle 安装方式有好几种，这里介绍下本地 Mac OX 上 Homebrew 安装和 Linux 上源码安装:

1、Homebrew 安装和升级

$ brew update && brew install gradle  //安装
$ brew upgrade gradle // 升级

2、Linux 源码安装

2.1 官网下载 gradle-4.1 源码包

2.2 解压缩源码包到指定目录

$ mkdir /opt/gradle
$ unzip -d /opt/gradle gradle-4.1-bin.zip

2.3 配置系统环境变量

$ export PATH=$PATH:/opt/gradle/gradle-4.1/bin

配置完成后，使用 gradle -v 查看是否安装成功。 注意：gradle 运行环境依赖 JKD | JRE 版本需要 >= 1.7。

4、Gradle 多模块项目搭建

4.1 创建 Muti-project 项目

首先创建项目 gradle_demo，并初始化 gradle。

mkdir gradle_demo && cd gradle_demo
gradle init

然后创建两个子模块，分别为 api 和 web，这里 api 我们打包成 jar，web 打包成 war，以示区别。

mkdir -p api/src/main/java
mkdir -p api/src/test/java
mkdir -p web/src/main/java
mkdir -p web/src/test/java
mkdir -p web/src/main/resources
mkdir -p web/src/main/webapp

4.2 修改各模块配置

首先修改父目录下 settings.gradle ，配置子模块：

include 'api','web'

然后修改父目录下 build.gradle ，配置子模块通用依赖

//子模块配置
subprojects {
    apply plugin: 'java'
    apply plugin: 'maven'
    apply plugin: "idea"
    ext {
        junitVersion = "4.11"
        springVersion = "4.3.3.RELEASE"
        jacksonVersion = "2.4.4"
        compileJava.options.encoding = 'UTF-8'
        compileTestJava.options.encoding = 'UTF-8'
    sourceCompatibility = 1.8
    targetCompatibility = 1.8
    tasks.withType(JavaCompile) {
        options.encoding = 'UTF-8'
    //配置依赖
    dependencies {
        compile(
                "org.springframework:spring-webmvc:${springVersion}",
                "org.springframework:spring-jdbc:${springVersion}",
                "org.springframework:spring-web:${springVersion}",
                "org.springframework:spring-oxm:${springVersion}",
                "org.springframework:spring-context-support:${springVersion}",
                "com.mangofactory:swagger-springmvc:1.0.2",
                "com.fasterxml.jackson.core:jackson-annotations:${jacksonVersion}",
                "com.fasterxml.jackson.core:jackson-databind:${jacksonVersion}",
                "com.fasterxml.jackson.core:jackson-core:${jacksonVersion}",
                "javax.mail:mail:1.4.7",
                "org.slf4j:slf4j-api:1.7.10",
                "org.slf4j:slf4j-log4j12:1.7.10",
                "log4j:log4j:1.2.17"
        testCompile("junit:junit:${junitVersion}")
接着修改子模块 api/build.gradle 定义 api 模块的其他依赖和配置
 
apply plugin: 'application'
group = "com.gradle.api"
version = "${rootProject.version}" //也可以不写，默认继承父模块 version
description = "this is gradle api demo"
archivesBaseName = 'gradle_api'
mainClassName = "com.gradle.api.Main" //指定 Jar 启动 Main
 
最后修改子模块 web/build.gradle 定义 web 模块的其他依赖和配置
 
apply plugin: 'war'
group = "com.gradle.web"
version = "${rootProject.version}" //也可以不写，默认继承父模块 version
description = "this is gradle web demo"
archivesBaseName = 'gradle_web'
//如果依赖子模块 api 时配置，若配置，则 build 该子模块时同时 build 依赖的子模块。
dependencies{
    compile project(":api")
配置完成后，执行 gradle build 即可 build 所有模块。 
 执行 gradle tasks --all 查看所有的 Task 列表。 
 执行 gradle api:build 只 build api 模块，执行 gradle web:build 会先 build api，然后 build web，这是因为 web 配置了依赖 api 模块 compile project(":api")。
 
5、类似 Maven Parent 继承方式实现
 
这里我们先在父项目根目录新建一个 common.gradle 的通用配置文件，配置一些我们依赖的其他插件，这里就以 gradle-release 和 java 插件为例，演示 release 版本管理操作以及 upload war | jar 到自定义 Nexus 服务地址上。
 
buildscript {
    repositories {
        jcenter()
    dependencies {
        classpath 'net.researchgate:gradle-release:2.4.0' // release plugin
apply plugin: 'java'
apply plugin: 'maven'
apply plugin: 'idea'
apply plugin: 'net.researchgate.release'
ext {
    civersion = System.getProperty("ci-version") ?: "${project.version}"
    maven_username = System.env.maven_username
    maven_password = System.env.maven_password
sourceCompatibility = 1.8
targetCompatibility = 1.8
tasks.withType(JavaCompile) {
    options.encoding = 'UTF-8'
//upload war | jar to nexus
uploadArchives {
    repositories {
        mavenDeployer {
            repository(url: "http://127.0.0.1:9998/nexus/content/repositories/releases") {
                authentication(userName: "${maven_username}", password: "${maven_password}")
            pom.version = "${civersion}"
            pom.artifactId = "${project.archivesBaseName}"
            pom.groupId = "${project.group}"
//config release task
release {
    tagCommitMessage = "[Gradle Release Plugin] - creating tag: "
    scmAdapters = [
            net.researchgate.release.GitAdapter,
//当需要 relase Task 之前执行 upload 操作时配置依赖
//afterReleaseBuild.dependsOn uploadArchives
 
注意： 
 1、这里我们使用了第三方插件 gradle-release:2.4.0 和官方 java 插件。 
 2、gradle-release 插件默认 Task release，可配置很多参数，详情可参考 GitHub gradle-release 配置使用。 
 3、配置 civerison 变量可接受命令行参数-Dci-version=${ci_version}形式传递，若不传默认取项目的 version，这里因为子模块都继承了父项目 version，能达到版本统一管理。 
 4、maven_username 和 maven_password 变量这里通过获取系统环境变量的方式获取。也可以通过命令行参数获取，还可以通过 gradle.properties 配置获取。 
 5、Task uploadArchives 这里配置了本地 Nexus 服务地址，Nexus 服务搭建可参照之前文章Java Maven项目之Nexus私服搭建和版本管理应用 搭建。pom.version = "${civersion}" 这里取 civersion变量，目的也是为了达到版本统一管理的目的。
 
好了，关键点来了，子模块如何使用 common.gradle 通用配置文件里面配置好的 Task呢？命令就是 apply from {path_common.gradle } | {http_common.gradle }
 
很简单，只需要一两步即可。不过大致分为两种情况：
 
第一种：所有模块都执行，那么只修改父项目根目录下 build.gradle 配置如下：
 
//获取 common.gradle 依赖插件配置
buildscript {
    repositories {
        jcenter()
    dependencies {
        classpath 'net.researchgate:gradle-release:2.4.0' // release plugin
//所有模块配置
allprojects {
    apply from: "${rootProject.projectDir}/common.gradle"
这样所有的子模块包括父项目都可以使用 common.gradle 里面配置好的 Task 了。当我们执行 gradle release 时，那么父项目以及子项目都会执行 release 操作了。是不是类似 Maven Parent 继承方式了。
 
那么问题来了，有人会问，如果我下边的子项目例如 rpc 模块，它是一个基础服务，它不使用该插件，这样执行会强制执行了 release 操作啦，再或者例如 api 模块，它不需要执行 release，再或者父项目只需要执行 release 不需要执行 upload 等等。
 
像这种问题，也可以解决掉，一种方式是启动时指定子模块或者父模块。
 
gradle release // 执行所有模块
gradle :release // 只执行父模块
gradle web:release // 只执行 web 子模块
gradle web:release api:release //只执行 web、api子模块
 
另一种方式是，配置 apply from: "${rootProject.projectDir}/common.gradle" 到指定子模块的 build.gradle 文件中，这样就只有该子模块可使用通用配置了。
 
第二种方式：指定模块执行方式，修改父项目根目录下 build.gradle 以及指定模块目录下 ${subMOdule}/build.gradle
 
1、修改父项目根目录下 build.gradle
//获取 common.gradle 依赖插件配置
buildscript {
    repositories {
        jcenter()
    dependencies {
        classpath 'net.researchgate:gradle-release:2.4.0' // release plugin
apply plugin: 'java'
apply plugin: 'net.researchgate.release' //指定父项目也可以使用 release 插件，不指定则父项目不可使用 release 插件。
//所有模块配置
allprojects {
      //配置仓库地址，以及第三方包地址( public 中找不到时，从 thirdparty 中找)
     repositories {
        maven {
            url "http://127.0.0.1:9998/nexus/content/groups/public"
            artifactUrls "http://127.0.0.1:9998/nexus/content/repositories/thirdparty"
2、修改 web 模块，web/build.gradle 增加配置：
apply from: "${rootProject.projectDir}/common.gradle"
 
注意：这里我设置 api 模块不继承 common.gradle，web 模块继承，父模块不继承只定义了 release 插件。
 
这样一来，在执行 gradle release 就执行父模块以及 web 模块了。如果父项目不配置使用release 插件，则执行 gradle release 就只执行 web 模块了。当然，执行 gradle web:release 还是会只执行 web 模块的。
 
具体 gradle-release 以及 java uploadArchives 插件操作效果这里就不截图演示了。跟 Java Maven项目之Nexus私服搭建和版本管理应用 文章后半部分版本管理应用功能类似。
 
6、FAQ
 
6.1 配置完 Muti-project 后，会去自动下载 https://services.gradle.org/distributions/gradle-{version}-all.zip，没有网络或者内网时下载不下来。解决办法如下：
 
1、到 ~/.gradle/wrapper/dists/gradle-{version}-all/ 下边，不规则命名的文件夹下边找到gradle-{version}-all.zip。
2、去指定网址下载该版本的 gradle-{version}-all.zip。 
将 gradle-{version}-all.zip 拷贝到该项目根目录 gradle/wrapper/ 下，并修改 gradle-wrapper.properties 配置，将 distributionUrl 修改为 distributionUrl=gradle-{version}-bin.zip 就可以了。
 
6.2 配置使用第三方插件有两种方式，当在 common.gradle 中，使用 plugins { ... } 方式时，子模块使用 apply from {path_common.gradle } | {http_common.gradle } 时，会报错
 
* What went wrong:
Could not compile script '/Users/wanyang3/git/gradle_demo/common.gradle'.
> startup failed:
  script '/Users/wanyang3/git/gradle_demo/common.gradle': 10: Only Project build scripts can contain plugins {} blocks
  See https://docs.gradle.org/4.1/userguide/plugins.html#sec:plugins_block for information on the plugins {} block
   @ line 10, column 1.
     plugins {
  1 error
 
这个 gradle 规定就是这样的，期待以后支持吧。解决办法就是换成如下方式：
 
buildscript {
    repositories {
        jcenter()
    dependencies {
        classpath 'net.researchgate:gradle-release:2.4.0' // release plugin
apply plugin: 'net.researchgate.release'
 
6.3 在 common.gradle 中已经定义了 buildscript { ... } 依赖插件，在父模块根目录 build.gradle 中不在指定 buildscript { ... }，会报错：
 
* What went wrong:
A problem occurred evaluating root project 'gradle_demo'.
> Plugin with id 'net.researchgate.release' not found.
 
这个需要在父模块根目录 build.gradle 中再次指定一下 buildscript { ... } 依赖插件就行。
 
==========================这里是分界线==========================
 
经过再次测试，发现也可在父模块根目录 build.gradle 中不指定 buildscript { ... } 依赖插件，也可以直接使用 common.gradle 定义的插件，方法就是：
 
修改 common.gradle 
buildscript {
    repositories {
        jcenter()
    dependencies {
        classpath 'net.researchgate:gradle-release:2.4.0' // release plugin
//apply plugin: 'net.researchgate.release' //注释掉，不使用此方式。
// 正解如下方式添加插件
if (!project.plugins.findPlugin(net.researchgate.release.ReleasePlugin))
    project.apply(plugin: net.researchgate.release.ReleasePlugin)
 
注意：net.researchgate.release.ReleasePlugin 这个是插件的主函数，可在该插件 GitHub 项目源码 src/main/resources/META-INF/gradle-plugins/net.researchgate.release.properties 文件中找到 implementation-class=net.researchgate.release.ReleasePlugin，应用其他插件方式同上即可。
 
Gradle Userguide
Gradle Install
GitHub gradle-release
                    Gradle 是基于 JVM 的构建工具，是基于 Ant 、Maven、ivy 概念的一款通用灵活的构建工具，基于 Groovy 脚本构建，目前支持 Java、Groovy、Kotlin 和 Scala 语言，能够满足日常开发中复杂构建需求的开源工具。定义公共插件扩展文件，项目需要使用的时候，直接继承 common.gradle 就能使用定义的 Task，实现类似 Maven Parent 继承方式
				
当您来自Maven背景时，很可能已经习惯了父pom结构。 
 现在，在进行gradle时，情况有所不同。 
 想象一下有一个包含接口和各种其他实现的项目的场景。   这将是我们的项目结构。 
multi-project-gradle
-- specification
-- core
-- implementation-a
-- implementation-b
 规范项目包含接口，实现将基于...
				
使用springboot+kotlin+ktor+gradle搭建多模块项目例子，该项目整合MybatisPlus做为数据库框架，可搭配文章‘SpringBoot整合Ktor2与MybatisPlus’ 与 ‘ktor 2.0的使用教程之实现log日志和jwt封装与异常处理’一起使用，希望有更多人希望ktor这个框架，目前看情况比springmvc要轻量级很多，由于ktor使用netty做为内置服务器，理论上会比springboot内置服务器性能要高，而且ktor是针对kotlin协程封装的，之所以推荐ktor主要是因为ktor与kotlin是一家公司推出的不用担心可维护性的问题，ktor适合做为微服务内置框架当然vertx也同样适合，但由于主要使用springboot做为kotlin的依赖注入优先考虑使用相同技术栈，目前ktor也是能对接Shiro做权限管理的，数据库访问层使用MybatisPlus目测也能达到主流开发框架之一，同样的使用kotlin可以简化一些代码。
				
参考文档:gradle的官方userguide.pdf文档的chapter 55和chapter 56.
gradle的多模块或项目开发一定不会比maven差,在我看来!大的项目分成多个模块来开发是常事.下文就介绍一下怎么用gradle开发多模块项目.对于gradle,在Eclipse和IDEA开者之间,毫无疑问选择IDEA作为IDE.
testweb是一个简单例子,项目只分成了core和web两个模块.其中core模块是放一些基本的或公共的java类,web模块放的是web Controller,配置,页面.所以最终打包项目时,core应打成一个jar包,而web模块引用(依赖)core模块,对于web的java类也打起一个jar包,这两个jar包最后是放在lib包下面再打成war包.项目的主要结构如下:
testweb
        resources
    build.gradle
        resources
    build.gradle
  build.gradle
  settings.gradle
core主要使用spring+spring data jpa(hibernate实现)+mysql
				
目录一：新建一个gradle工程二：修改工程三：新建子模块四：修改父模块setting.gradle五：修改gradle插件六：测试
利用gradle进行多模块架构，用于代码解耦
一：新建一个gradle工程
以springboot为例
选择gradle project
可以什么都不选
选择本地gradle
二：修改工程
删除src文件
修改build.gradle文件/*
				
如果在使用Gradle过程中有任何疑问，都建议去官网溜达溜达：https://docs.gradle.org/current/userguide/userguide.html
Gradle是什么
Gradle是一款开源的自动化构建工具，可以灵活的构建任何类型软件（基本上），比如我们日常开发所熟知的：
Java的产物（.JAR）
Android Application的产物（.APK）
Android Library的产物（.AAR）
目前Gradle已经是Android官方首推的自动化构建工具线，也是我们
				
官方文档：https://docs.gradle.org/current/userguide/declaring_dependencies.html
声明依赖：在研究依赖声明之前，需要定义依赖配置(dependency configuration)的概念。
什么是依赖配置：
 每个为gradle 项目声明依赖的依赖关系都使用于一个特定的范围，例如一些依赖项应该用于编译源代码，而其他依赖项只需要在运行时可用即可，Gradle 在配置 （configuration）的帮助下表示依赖的范围，每个配置都可..
我这安装的是6.6.1
C:\Users\herion>gradle -v
------------------------------------------------------------
Gradle 6.6.1
------------------------------------------------------------
Build time:   2020-08-25 16:29:12 UTC
Revision:     f2d1fb54a951d8b11d25748e4711bec8d128d7e3
Kotlin:       1.3.72
Groovy:      
				
Gradle 和 Maven 是两种构建工具，它们都可以帮助开发人员管理和构建项目。但是，它们有一些显著的区别：
1. 基础架构不同：Gradle 基于 Groovy 语言开发，而 Maven 基于 XML。这意味着 Gradle 的构建脚本看起来更像程序代码，而 Maven 的构建脚本看起来更像配置文件。
2. 依赖管理方式不同：Maven 使用预定义的规则来管理依赖关系，而 Gradle 可以自定义依赖管理规则。
3. 扩展性不同：Maven 插件是固定的，而 Gradle 插件是可扩展的。
4. 性能不同：Gradle 的性能优于 Maven，因为它支持并行构建和缓存。
总的来说，Gradle 和 Maven 都是很好的构建工具，但它们适用于不同的场景。Maven 更适合大型项目，因为它有着严格的规范和良好的文档，而 Gradle 则更适合快速迭代和持续交付的项目，因为它具有更高的扩展性和更好的性能。