您希望在一个项目中由某个任务生成的文件,能够被另一个项目中的任务共享使用。例如,一个任务生成一个文件,另一个任务读取该文件并使用其中的一些信息。这是跨项目边界共享信息的一种方式。(另一种方式是使用扩展对象。)

这演示了跨项目边界共享信息的简单版本,通过明确指定要使用哪个生产者项目的可消费配置来获取本地可用的工件。

当生产者将工件发布到仓库时,要检索该工件,您需要使用变体感知依赖解析的高级版本。此方法也可在本地使用。

示例

示例 1. 设置
settings.gradle.kts
rootProject.name = "sharing-outputs"
include("producer")
include("consumer")
settings.gradle
rootProject.name = "sharing-outputs"
include("producer")
include("consumer")
producer/build.gradle.kts
val makeFile = tasks.register("makeFile") {
    val sharedFile = layout.buildDirectory.file("some-subdir/shared-file.txt")
    outputs.file(sharedFile)
    doFirst {
        sharedFile.get().asFile.writeText("This file is shared across Gradle subprojects.")
    }
}

val sharedConfiguration by configurations.creating {
    isCanBeResolved = false
}

artifacts {
    add(sharedConfiguration.name, makeFile)
}
producer/build.gradle
def makeFile = tasks.register("makeFile") {
    def sharedFile = layout.buildDirectory.file("some-subdir/shared-file.txt")
    outputs.file(sharedFile)
    doFirst {
        sharedFile.get().asFile << "This file is shared across Gradle subprojects."
    }
}

configurations {
    sharedConfiguration {
        canBeResolved = false
    }
}

artifacts {
    sharedConfiguration(makeFile)
}
consumer/build.gradle.kts
val sharedConfiguration: Configuration by configurations.creating {
    isCanBeConsumed = false
}

dependencies {
    sharedConfiguration(project(path = ":producer", configuration = "sharedConfiguration"))
}

tasks.register("showFile") {
    val sharedFiles: FileCollection = sharedConfiguration
    inputs.files(sharedFiles)
    doFirst {
        logger.lifecycle("Shared file contains the text: '{}'", sharedFiles.singleFile.readText())
    }
}
consumer/build.gradle
configurations {
    sharedConfiguration {
        canBeConsumed = false
    }
}

dependencies {
    sharedConfiguration(project("path": ":producer", "configuration": "sharedConfiguration"))
}

tasks.register("showFile") {
    FileCollection sharedFiles = configurations.getByName("sharedConfiguration")
    inputs.files(sharedFiles)
    doFirst {
        logger.lifecycle("Shared file contains the text: '{}'", sharedFiles.singleFile.text)
    }
}

另请参阅

反模式:

不要直接引用其他项目任务

声明跨项目依赖关系的常见反模式如下。

这种发布模型是不安全的,可能导致构建不可重现且难以并行化。通过这种方式声明依赖关系,在 Gradle 决定给定构建的任务顺序时,消费者和生产者之间的任务顺序是未知的。这意味着,文件“someOtherJar”的消费者可能会在创建该 jar 的生产者任务之前执行!这将导致构建要么完全中断,要么更糟,以一种微妙、不稳定且难以调试的方式中断。

dependencies {
  // This publication model can make your build flaky and broken!
  implementation project(":other").tasks.someOtherJar
}