如何将Gradle自定义任务输出作为构件使用？

当然可以实现类似Zip任务那样的效果！咱们先拆解下你遇到的问题，再一步步解决：

为什么最初的尝试失败了？ #

1. 直接将任务作为构件报错：Gradle的artifacts配置只接受实现了ConfigurablePublishArtifact接口的对象，普通的自定义任务（比如你最初写的createFile）并没有实现这个接口，所以会抛出类型转换错误。而像Zip这类内置任务，Gradle已经为它们做了适配，允许直接作为构件使用。
2. 用输出文件作为构件但无依赖：当你改用createFile.outputs.files.singleFile时，虽然Gradle不再报错，但你只是传递了一个文件路径，Gradle无法识别这个文件来自哪个任务，自然不会自动建立copySourceDependencies和createFile之间的任务依赖，导致干净构建时因为找不到文件而跳过拷贝任务。

正确的实现方式：使用类型安全的输出属性 #

要让Gradle识别任务间的依赖，关键是让自定义任务的输出成为可追踪的任务属性，而不是直接暴露文件路径。具体步骤如下：

1. 定义自定义任务类 #

首先创建一个可复用的自定义任务类（比如放在util.gradle中），使用Gradle的类型安全属性（RegularFileProperty）并标记@OutputFile，这样Gradle能自动追踪这个输出文件与任务的关联：

class CreateFile extends DefaultTask {
    @OutputFile
    RegularFileProperty outputFile = project.objects.fileProperty()

    @TaskAction
    void createFile() {
        def tOutFile = outputFile.get().asFile
        tOutFile.parentFile.mkdirs()
        tOutFile.text = "Hello World"
    }
}

rootProject.ext.CreateFile = CreateFile

2. 在projectA中配置自定义任务并关联构件 #

在projectA的build.gradle中引用这个任务类，配置输出文件，然后将任务的outputFile属性作为myDistConfig的构件：

apply from 'util.gradle'

task createFile(type: CreateFile) {
    outputFile = rootProject.file("${buildDir}/tmp/outputFile.txt")
}

configurations { myDistConfig }
artifacts { myDistConfig createFile.outputFile }

3. projectB的配置保持不变 #

projectB中原来的配置不需要修改，Gradle现在会自动识别mySourceConfig中的构件来自projectA的createFile任务，从而在执行copySourceDependencies前先触发createFile任务：

configurations { mySourceConfig }
dependencies {
    mySourceConfig project(path: ':projectA', configuration: 'myDistConfig')
}

task copySourceDependencies(type: Copy) {
    from configurations.mySourceConfig
    into contextDir
}

为什么这样能生效？ #

通过@OutputFile注解RegularFileProperty，Gradle会将这个属性与任务绑定，当你把createFile.outputFile作为构件时，Gradle不仅会传递文件路径，还会记录这个文件的生产者任务（createFile）。这样跨项目依赖时，Gradle就能自动建立任务间的依赖关系，确保在需要使用这个文件前，先执行生成它的任务。

内容的提问来源于stack exchange，提问作者dpr