如果一个子项目依赖于另一个子项目怎么办？如果一个项目需要另一个项目生成的工件怎么办？

构建构建2

这是多项目构建的常见用例。 Gradle为此提供了项目依赖项。

取决于另一个项目

让我们探索具有以下布局的理论多项目构建：

.
├── api
│   ├── src
│   │   └──...
│   └── build.gradle.kts
├── services
│   └── person-service
│       ├── src
│       │   └──...
│       └── build.gradle.kts
├── shared
│   ├── src
│   │   └──...
│   └── build.gradle.kts
└── settings.gradle.kts
.
├── api
│   ├── src
│   │   └──...
│   └── build.gradle
├── services
│   └── person-service
│       ├── src
│       │   └──...
│       └── build.gradle
├── shared
│   ├── src
│   │   └──...
│   └── build.gradle
└── settings.gradle

在此示例中，有三个子项目，分别称为shared、api和person-service：

  1. 该person-service子项目依赖于其他两个子项目，shared和api。

  2. 子项目api取决于shared子项目。

我们使用:分隔符来定义项目路径，例如services:person-service或:shared。有关定义项目路径的更多信息，请参阅Settings.include(java.lang.String[])的 DSL 文档。

settings.gradle.kts
rootProject.name = "dependencies-java"
include("api", "shared", "services:person-service")
shared/build.gradle.kts
plugins {
    id("java")
}

repositories {
    mavenCentral()
}

dependencies {
    testImplementation("junit:junit:4.13")
}
api/build.gradle.kts
plugins {
    id("java")
}

repositories {
    mavenCentral()
}

dependencies {
    testImplementation("junit:junit:4.13")
    implementation(project(":shared"))
}
services/person-service/build.gradle.kts
plugins {
    id("java")
}

repositories {
    mavenCentral()
}

dependencies {
    testImplementation("junit:junit:4.13")
    implementation(project(":shared"))
    implementation(project(":api"))
}
settings.gradle
rootProject.name = 'basic-dependencies'
include 'api', 'shared', 'services:person-service'
shared/build.gradle
plugins {
    id 'java'
}

repositories {
    mavenCentral()
}

dependencies {
    testImplementation "junit:junit:4.13"
}
api/build.gradle
plugins {
    id 'java'
}

repositories {
    mavenCentral()
}

dependencies {
    testImplementation "junit:junit:4.13"
    implementation project(':shared')
}
services/person-service/build.gradle
plugins {
    id 'java'
}

repositories {
    mavenCentral()
}

dependencies {
    testImplementation "junit:junit:4.13"
    implementation project(':shared')
    implementation project(':api')
}

项目依赖性会影响执行顺序。它会导致首先构建另一个项目，并将输出与另一个项目的类添加到类路径中。它还将其他项目的依赖项添加到类路径中。

如果执行./gradlew :api:compile，则首先shared构建项目，然后api构建项目。

取决于另一个项目生成的工件

有时，您可能希望依赖另一个项目中特定任务的输出，而不是整个项目。然而，不鼓励显式声明从一个项目到另一个项目的任务依赖关系，因为它会引入任务之间不必要的耦合。

对依赖项进行建模的推荐方法是生成输出并将其标记为“传出”工件，其中一个项目中的任务依赖于另一个项目的输出。 Gradle 的依赖管理引擎允许您在项目之间共享任意工件并按需构建它们。