vlambda博客
学习文章列表

我们看到每次调用 printInfo 任务的输出。 project 任务的路径也会显示出来。根项目用冒号 ​​(:) 表示，没有明确的名称。 flower 项目被引用为 :flower，而 printInfo flower 项目的任务被引用为 :flower:printInfo。任务的路径是项目的名称，用冒号 (:) 后跟任务名称。冒号分隔项目和任务名称。我们还可以使用命令行中的这种语法来引用项目中的特定任务。如果我们要调用 flower项目的 printInfo任务，可以运行如下命令：

garde $ gradle :flower:printInfo
:flower:printInfo
This is flower
BUILD SUCCESSFUL
Total time: 0.649 secs

这也适用于从另一个项目目录执行根项目中的任务。如果我们先进入flower项目目录，想要执行根项目的 printInfo任务，必须使用  ;:printInfo 语法。如果我们从 执行根项目、当前项目和 flower项目的 printInfo任务，我们得到以下输出;tree 项目目录：

tree $ gradle :printInfo printInfo :flower:printInfo
:printInfo
This is garden
:tree:printInfo
This is tree
:flower:printInfo
This is flower
BUILD SUCCESSFUL
Total time: 0.632 secs

Gradle 需要几个步骤来确定一个项目是必须作为单项目构建还是多项目构建执行，如下所示：

我们可以强制 Gradle 不在父目录中查找 settings.gradle 文件，使用 --no-search-upward（或-u）命令行参数。

在我们当前的项目设置中，我们定义了项目的分层布局。我们将 settings.gradle 文件放在父目录下，并通过 include()方法，我们添加了 <将 code class="literal">tree 和 flower 项目添加到我们的多项目构建中。

我们还可以使用平面布局来设置我们的多项目构建，可以如下完成：

我们在 tree和 flowerbuild.gradle文件> 具有printInfo 任务实现的项目。但是，有了 Gradle 的多项目支持，我们就不必这样做了。我们可以在根build.gradle 文件中定义所有项目任务和属性。我们可以使用它在一个地方为所有项目定义通用功能。

我们可以使用 project() 方法引用项目，并使用项目的完整名称作为参数。我们必须使用闭包来定义项目的任务和属性。

对于我们的示例项目，我们将首先从 tree和 build.gradle文件">花 目录。接下来，我们将更改 master目录下的 build.gradle文件。在这里，我们将使用 project()方法定义 printInfo任务>tree 和 flower 项目，如下：

task printInfo << { 
    println "This is ${project.name}" 
} 
 
project(':flower') { 
    // Add an extra action to the printInfo task. 
    task printInfo << { 
        println "This is ${project.name}" 
    } 
} 
 
project(':tree') { 
    // Add an extra action to the printInfo task. 
    task printInfo << { 
        println "This is ${project.name}" 
    } 
} 

如果我们从 master目录执行printInfo任务，我们可以看到所有 调用项目的 printInfo 任务：

master $ gradle printInfo
:printInfo
This is master
:flower:printInfo
This is flower
:tree:printInfo
This is tree
BUILD SUCCESSFUL
Total time: 0.674 secs

Gradle 还具有 allprojects{} 脚本块，用于将项目任务和属性应用于作为多项目构建一部分的所有项目。我们可以重写我们的 build.gradle 文件并使用 allprojects{} 脚本块来获得任务的清晰定义无需重复：

allprojects { 
    // Add task printInfo to all projects: 
    // master, flower and tree 
    task printInfo << { 
        println "This is ${project.name}" 
    } 
} 

如果我们从master目录调用printInfo任务，我们可以看到每个项目都有新添加的任务：

master $ gradle -q printInfo
This is master
This is flower
This is tree

如果我们只想配置tree和 flower子项目，我们必须使用 子项目{} 脚本块。使用此脚本块，仅配置多项目构建的子项目的任务和属性。在下面的示例构建文件中，我们将只配置 子项目：

subprojects { 
    // Add task printInfo to all sub projects: 
    // flower and tree 
    task printInfo << { 
        println "This is ${project.name}" 
    } 
} 

如果我们调用 printInfo 任务，我们可以看到我们的 master项目不再有 printInfo 任务：

master $ gradle -q printInfo
This is flower
This is tree

如果没有为单个项目定义 printInfo 任务，Gradle 不会抛出异常。 Gradle 将首先为作为多项目构建一部分的所有项目构建一个完整的任务图。如果任何项目包含我们要运行的任务，则执行该项目的任务。只有当所有项目都没有任务时，Gradle 才会使构建失败。

我们可以将 allprojects{} 和 subprojects{} 脚本块和 项目() 方法来定义常见行为并为特定项目应用特定行为。在以下示例构建文件中，我们在不同级别为printInfo 任务添加了额外的功能：

allprojects { 
    task printInfo << { 
        println "This is ${project.name}" 
    } 
} 
 
subprojects { 
    // Add an extra action to the printInfo task. 
    printInfo << { 
        println "Can be planted" 
    } 
} 
 
project(':tree') { 
    // Add an extra action to the printInfo task. 
    printInfo << { 
        println "Has leaves" 
    } 
} 
 
project(':flower') { 
    // Add an extra action to the printInfo task. 
    printInfo << { 
        println "Smells nice" 
    } 
} 

现在当我们执行 printInfo 任务时，我们将得到以下输出：

master $ gradle printInfo
:printInfo
This is master
:flower:printInfo
This is flower
Can be planted
Smells nice
:tree:printInfo
This is tree
Can be planted
Has leaves
BUILD SUCCESSFUL
Total time: 0.631 secs

我们使用 project( ) 方法。但是，我们也可以将 build.gradle 文件添加到 树和 flower 项目并在那里添加了额外的功能。

要将特定配置应用于多个项目，我们还可以使用项目过滤。在我们的 build.gradle 文件中，我们必须使用 configure() 方法。我们将根据项目名称定义一个过滤器作为方法的参数。在闭包中，我们为每个找到的项目定义配置。

在以下示例构建文件中，我们使用项目过滤器来查找名称以 f 开头的项目，然后将配置应用于项目，如下所示：

allprojects { 
    task printInfo << { 
        println "This is ${project.name}" 
    } 
} 
 
// Find all projects that start with an f. 
    ext { 
    projectsWithF = 
        allprojects.findAll { project -> 
            project.name.startsWith('f') 
     } 
} 
 
// Configure the found projects. 
configure(projectsWithF) { 
    printInfo << { 
        println 'Smells nice' 
    } 
} 

当我们执行 printInfo 任务时，我们得到以下输出：

master $ gradle printInfo
:flower:printInfo
This is flower
Smells nice
BUILD SUCCESSFUL
Total time: 0.231 secs

我们使用项目名称作为过滤器。我们还可以使用项目属性来定义过滤器。由于项目属性仅在定义构建后设置，可以使用 build.gradle 文件或 project()方法，我们必须使用 afterEvaluate()方法。一旦配置了所有项目并设置了项目属性，就会调用此方法。我们会将自定义配置作为闭包传递给 afterEvaluate() 方法。

在以下示例构建文件中，我们读取了 hasLeaves 项目属性，用于 tree 和 花项目。如果属性是 true，我们为这个项目自定义 printInfo任务：

allprojects { 
    task printInfo << { 
        println "This is ${project.name}" 
    } 
} 
 
subprojects { 
    // After all projects have been evaluated 
    // the properties are set and we can check 
    // the value. 
    afterEvaluate { project -> 
        if (project.hasLeaves) { 
            printInfo << { 
                println "Has leaves" 
          } 
      } 
  } 
} 
 
project(':tree') { 
    ext.hasLeaves = true 
} 
 
project(':flower') { 
    ext.hasLeaves = false 
} 

当我们从master目录执行printInfo任务时，我们得到以下输出：

master $ gradle printInfo
:printInfo
This is master
:flower:printInfo
This is flower
:tree:printInfo
This is tree

as leaves
BUILD SUCCESSFUL
Total time: 0.667 secs

如果我们调用 printInfo 任务，我们看到 flower的 printInfo任务 项目在 tree 项目之前执行。 Gradle 默认使用项目的字母顺序来确定任务的执行顺序。我们可以通过定义不同项目中任务之间的显式依赖关系来改变这个执行顺序。

如果我们首先要在 flower之前执行 tree项目的printInfo任务项目，我们可以定义flower项目的 printInfo任务依赖于 tree 项目的 "literal">printInfo 任务。在下面的示例构建文件中，我们将更改 flower项目中的 printInfo任务的依赖关系。我们将使用 dependsOn()方法来引用 的 printInfo任务树项目，如下：

allprojects { 
    task printInfo << { 
        println "This is ${project.name}" 
    } 
} 
 
project(':flower') { 
    printInfo.dependsOn(':tree:printInfo') 
} 

如果我们执行 printInfo任务，我们将在输出中看到printInfo任务literal">tree 项目在 flower 项目的 printInfo 任务之前执行：

master $ gradle printInfo
:printInfo
This is master
:tree:printInfo
This is tree
:flower:printInfo
This is flower
BUILD SUCCESSFUL
Total time: 0.637 secs

除了项目之间的任务依赖外，我们还可以包含其他配置依赖。例如，我们可以让一个项目设置的项目属性被另一个项目使用。 Gradle 将按字母顺序评估项目。在下面的例子中，我们将在 tree目录下新建一个build.gradle文件，并在根目录下设置一个属性项目：

rootProject.ext.treeMessage = 'I am a tree' 

我们还将在 flower 项目中创建一个 build.gradle 文件，并根据根项目设置一个具有值的项目属性tree 项目设置的属性，如下：

ext.message = rootProject.hasProperty('treeMessage') ? 
 rootProject.treeMessage : 'is not set' 
 
printInfo << { 
    println "Tree say ${message}" 
} 

当我们执行 printInfo 任务时，我们得到以下输出：

master $ gradle printInfo
:printInfo
This is master
:flower:printInfo
This is flower
Tree say I am a tree
:tree:printInfo
This is tree
BUILD SUCCESSFUL
Total time: 0.578 secs

请注意，flower 项目中的 printInfo 任务无法显示根项目属性的值，因为该值尚未设置 tree 项目。为了改变项目的求值顺序，我们可以明确定义 flower项目依赖于 tree项目和  ;evaluationDependsOn() 方法。我们可以修改 flower目录下的 build.gradle文件，添加 evaluationDependsOn (':tree') 到文件顶部：

evaluationDependsOn(':tree') 
 
ext.message = rootProject.hasProperty('treeMessage') ? 
  rootProject.treeMessage : 'is not set' 
 
printInfo << { 
    println "Tree say ${message}" 
} 

当我们再次执行 printInfo 任务时，我们在输出中看到根项目属性的值在 flower 项目：

master $ gradle printInfo
:printInfo
This is master
:flower:printInfo
This is flower
Tree say I am a tree
:tree:printInfo
This is tree
BUILD SUCCESSFUL
Total time: 0.578 secs

由于项目之间的 lib 依赖关系，我们可以在 Gradle 中执行部分构建。这意味着我们不必在项目的根目录中构建必要的项目。我们可以切换到项目目录并从那里调用构建任务，Gradle 将首先构建所有必要的项目，然后是当前项目。

让我们切换到 services/sample 目录，从那里调用构建任务，然后检查输出：

$ cd services/sample
sample $ gradle build
:common:compileJava
:common:processResources UP-TO-DATE
:common:classes
:common:jar
:services:sample:compileJava
:services:sample:processResources UP-TO-DATE
:services:sample:classes
:services:sample:jar
:services:sample:assemble
:services:sample:compileTestJava
:services:sample:processTestResources UP-TO-DATE
:services:sample:testClasses
:services:sample:test
:services:sample:check
:services:sample:build
BUILD SUCCESSFUL
Total time: 1.676 secs

:common 项目是在我们的:services:sample 项目之前构建的。如果我们不想构建我们所依赖的项目，我们必须使用 --no-rebuild（或- a) 命令行参数。然后，Gradle 将跳过构建我们项目所依赖的项目，并将使用缓存版本的依赖项。

当我们在调用 build 任务时使用 -a 参数时，我们会得到以下输出：

sample $ gradle -a build
:services:sample:compileJava UP-TO-DATE
:services:sample:processResources UP-TO-DATE
:services:sample:classes UP-TO-DATE
:services:sample:jar UP-TO-DATE
:services:sample:assemble UP-TO-DATE
:services:sample:compileTestJava UP-TO-DATE
:services:sample:processTestResources UP-TO-DATE
:services:sample:testClasses UP-TO-DATE
:services:sample:test UP-TO-DATE
:services:sample:check UP-TO-DATE
:services:sample:build UP-TO-DATE
BUILD SUCCESSFUL
Total time: 0.638 secs

如果我们在我们的 :services:sample 项目中调用 build 任务，则 ： common 项目也已构建。但是，有一个问题，因为只有  :common 项目的 jar 任务被执行。通常， build 任务也会运行测试并执行 check 任务。仅当项目构建为 lib 依赖项时，Gradle 才会跳过这些任务。

如果我们要执行依赖项目的测试和检查，我们必须执行 buildNeeded 任务。 Gradle 然后将执行所有依赖项目的完整构建。让我们从 s ervices/sample 目录执行 buildNeeded 任务并查看输出：

sample $ gradle buildNeeded
:common:compileJava UP-TO-DATE
:common:processResources UP-TO-DATE
:common:classes UP-TO-DATE
:common:jar UP-TO-DATE
:common:assemble UP-TO-DATE
:common:compileTestJava UP-TO-DATE
:common:processTestResources UP-TO-DATE
:common:testClasses UP-TO-DATE
:common:test UP-TO-DATE
:common:check UP-TO-DATE
:common:build UP-TO-DATE
:common:buildNeeded UP-TO-DATE
:services:sample:compileJava UP-TO-DATE
:services:sample:processResources UP-TO-DATE
:services:sample:classes UP-TO-DATE
:services:sample:jar UP-TO-DATE
:services:sample:assemble UP-TO-DATE
:services:sample:compileTestJava UP-TO-DATE
:services:sample:processTestResources UP-TO-DATE
:services:sample:testClasses UP-TO-DATE
:services:sample:test UP-TO-DATE
:services:sample:check UP-TO-DATE
:services:sample:build UP-TO-DATE
:services:sample:buildNeeded UP-TO-DATE
BUILD SUCCESSFUL
Total time: 0.651 secs

如果我们对 :services:sample 项目进行了更改，我们可能还需要依赖于 sample 项目的项目被建造。我们可以使用它来确保我们没有破坏任何依赖于我们项目的代码。 Gradle 有一个 buildDependents 任务来执行此操作。例如，让我们从我们的 :services:sample项目执行这个任务，我们的 :web项目也是这样构建的依赖于 :services:sample 项目。当我们执行 buildDependents任务时，我们会得到如下输出：

sample $ gradle buildDependents
:common:compileJava UP-TO-DATE
:common:processResources UP-TO-DATE
:common:classes UP-TO-DATE
:common:jar UP-TO-DATE
:services:sample:compileJava UP-TO-DATE
:services:sample:processResources UP-TO-DATE
:services:sample:classes UP-TO-DATE
:services:sample:apiJar
:services:sample:jar UP-TO-DATE
:web:compileJava
:web:processResources UP-TO-DATE
:web:classes
:web:war
:web:assemble
:web:compileTestJava UP-TO-DATE
:web:processTestResources UP-TO-DATE
:web:testClasses UP-TO-DATE
:web:test UP-TO-DATE
:web:check UP-TO-DATE
:web:build
:web:buildDependents
:services:sample:assemble UP-TO-DATE
:services:sample:compileTestJava UP-TO-DATE
:services:sample:processTestResources UP-TO-DATE
:services:sample:testClasses UP-TO-DATE
:services:sample:test UP-TO-DATE
:services:sample:check UP-TO-DATE
:services:sample:build UP-TO-DATE
:services:sample:buildDependents
BUILD SUCCESSFUL
Total time: 0.709 secs