Gradle学习系列之八—— 构建多个Project

客官°小女子只卖身不卖艺 2022-12-16 00:48 133阅读 0赞

> 学习了大佬的文章，感觉写的太好了，感谢大佬分享 ，可惜是gradle4.x的，升级为6.5。大佬博客地址 https://www.cnblogs.com/davenkin/p/gradle-learning-1.html

这是一个关于Gradle的学习系列，其中包含以下文章：

1.  [Gradle快速入门][Gradle]
2.  [创建Task的多种方法][Task]
3.  [读懂Gradle语法][Gradle 1]
4.  [增量式构建][Link 1]
5.  [自定义Property][Property]
6.  [使用java Plugin][java Plugin]
7.  [依赖管理][Link 2]
8.  [构建多个Project][Project]
9.  [自定义Task类型][Task 1]
10. [自定义Plugin][Plugin]

> 请通过以下方式下载本系列文章的Github示例代码：

https://github.com/ZhangDi-d/gradle-learning.git

--------------------

## Gradle学习系列之八—— 构建多个Project ##

Gradle为每个build.gradle都会创建一个相应的Project领域对象，在编写Gradle脚本时，我们实际上是在操作诸如Project这样的Gradle领域对象。

在多Project的项目中，我们会操作多个Project领域对象。Gradle提供了强大的多Project构建支持。

要创建多Project的Gradle项目，我们首先需要在根（Root）Project中加入名为settings.gradle的配置文件，该文件应该包含各个子Project的名称。

比如，我们有一个根Project名为root-project，它包含有两个子Project，名字分别为sub-project1和sub-project2，此时对应的文件目录结构如下：

root-project/
       sub-project1/
           build.gradle
       sub-project2/
           build.gradle
       build.gradle
       settings.gradle

root-project本身也有自己的build.gradle文件，同时它还拥有settings.gradle文件位于和build.gradle相同的目录下。此外，两个子Project也拥有他们自己的build.gradle文件。

要将sub-project1和sub-project2加入到root-project的子Project中，我们需要在settings.gradle中加入：

include 'sub-project1', 'sub-project2'

接下来，我们来定义一个Task用于显示每个Project各自的名称。我们可以在每个build.gradle进行定义，但是这却是一种比较笨的方法，此时我们也完全没有享受到Gradle的多Project构建功能所带来的好处。在Gradle中，我们可以通过根Project的allprojects()方法将配置一次性地应用于所有的Project，当然也包括定义Task。比如，在root-project的build.gradle中，我们可以做以下定义：

allprojects { 
        apply plugin: 'idea'
        task allTask { 
            doLast { 
                println project.name
            }
        }
    }

以上Gradle脚本，将闭包中的代码应用在所有的Project中，包括root-project本身。我们首先将应用了idea Plugin用于生成IntelliJ工程，其次我们定义了名为allTask的Task，该  
Task应用于每个Project，作用是输出各个Project的名称。执行“gradle allTask”，命令行输出如下：

> Task :allTask
    root-project
    
    > Task :sub-project1:allTask
    sub-project1
    
    > Task :sub-project2:allTask
    sub-project2

我们看到，该allTask对于每个Project都执行了一次，在执行时输出了当前Project的名称。

除了allprojects()之外，Project还提供了subprojects()方法用于配置所有的子Project（不包含根Project）。比如，我们可以定义Task来只输出各个子Project的名字：

subprojects { 
        task subTask { 
            doLast { 
                println project.name
            }
        }
    }

执行“gradle subTask”，命令行输出如下：

> Task :sub-project1:subTask
    sub-project1
    
    > Task :sub-project2:subTask
    sub-project2

此时的输出中不包含root-project的名字。

上文中已经提到，在Gradle脚本中，我们实际上是在操作一些领域对象，因此我们可以将groovy的所有语言特性用在Gradle的领域对象上，比如我们可以对Project进行过滤：

configure(allprojects.findAll {  it.name.startsWith('sub') }) { 
        subTask { 
            doLast { 
                println 'this is a sub project'
            }
        }
    }

在上面的代码中，我们先找到所有Project中名字以“sub”开头的Project，然后再对这些Project进行配置，在配置中，我们向这些Project的subTask中加入了一条额外的打印语句。  
此时如果再执行“gradle subTask”，命令行输出如下：

> Task :sub-project1:subTask
    sub-project1
    this is a sub project
    
    > Task :sub-project2:subTask
    sub-project2
    this is a sub project

到此为止，我们所有的Task定义工作都是在root-project中进行的，而sub-project1和sub-project2中的build.gradle文件依然什么都没有。事实上，我们可以将所有子Project的配置均放在根Project中进行。在上面的例子中，我们通过allprojects()和subprojects()将所有的子Project都包含在了配置之内，其实我们还可以对某个Project进行单独配置。比如，在root-project的build.gradle中加入：

project(':sub-project1') { 
        task forProject1 { 
            doLast { 
                println 'for project 1'
            }
        }
    }

以上脚本向sub-project1中加入了名为forProject1的Task，在执行“gradle forProject1”时，终端输出如下：

> Task :sub-project1:forProject1
    for project 1

这里有一个问题：我们是在root-project下执行的命令，因此照理说Gradle会认为forProject1是定义在所有的Project上，而此时只有sub-project1才拥有该Task，Gradle应该抛出异常指示在root-project和sub-project2上找不到该Task才对，为什么它还是执行成功了呢？原因在于：只有在一个Task没有在任何Project中定义时，Gradle才会将其当做异常。否则，Gradle会在所有拥有该Task的Project上执行该Task。

一旦有了多个Project，他们之间便会存在着依赖关系。**Gradle的Project之间的依赖关系是基于Task的**，而不是整个Project的。

现在，让我们来看一个Project依赖的例子。比如sub-project1中有taskA和taskB，taskA依赖于taskB：

task taskA { 
        doLast { 
            println 'this is taskA from project 1'
        }
    }
    
    task taskB { 
        doLast { 
            println 'this is taskB from project 1'
        }
    }
    
    taskA.dependsOn taskB

在执行“gradle taskA”时，终端输出：

> Task :sub-project1:taskB
    this is taskB from project 1
    
    > Task :sub-project1:taskA
    this is taskA from project 1

这个很容易理解，两个Task都是属于sub-project1的。但是，让我们再向其中加入一些复杂性。我们在sub-project2中定义taskC和taskD，然后使taskA再依赖于taskC，又使taskB依赖于taskD：

//project 1
    
    task taskA { 
        doLast { 
            println 'this is taskA from project 1'
        }
    }
    
    task taskB { 
        doLast { 
            println 'this is taskB from project 1'
        }
    }
    
    taskA.dependsOn taskB
    
    taskA.dependsOn ':sub-project2:taskC'
    
    taskB.dependsOn ':sub-project2:taskD'
    
    //project 2
    
    task taskC { 
        doLast { 
            println 'this is taskC from project 2'
        }
    }
    
    task taskD  { 
        doLast { 
            println 'this is taskD from project 2'
        }
    }

此时再执行“gradle taskA”，终端输出如下：

> Task :sub-project2:taskD
    this is taskD from project 2
    
    > Task :sub-project1:taskB
    this is taskB from project 1
    
    > Task :sub-project2:taskC
    this is taskC from project 2
    
    > Task :sub-project1:taskA
    this is taskA from project 1

分析一下：taskA依赖于taskB，而taskB又依赖于taskD，所以sub-project1的taskD首先得到了执行，然后再执行sub-project1的taskB。之后，又由于taskA依赖于taskC，故Gradle再次转向sub-project1执行taskC，最后才执行taskA。

[Gradle]: https://blog.csdn.net/ShelleyLittlehero/article/details/109139597
[Task]: https://blog.csdn.net/ShelleyLittlehero/article/details/109143731
[Gradle 1]: https://blog.csdn.net/ShelleyLittlehero/article/details/109143763
[Link 1]: https://blog.csdn.net/ShelleyLittlehero/article/details/109143791
[Property]: https://blog.csdn.net/ShelleyLittlehero/article/details/109143863
[java Plugin]: https://blog.csdn.net/ShelleyLittlehero/article/details/109143907
[Link 2]: https://blog.csdn.net/ShelleyLittlehero/article/details/109143955
[Project]: https://blog.csdn.net/ShelleyLittlehero/article/details/109143979
[Task 1]: https://blog.csdn.net/ShelleyLittlehero/article/details/109144006
[Plugin]: https://blog.csdn.net/ShelleyLittlehero/article/details/109144024