如何在Gradle中判断特定输入是否未更新？无此方法是否为不良模式？

首先直接给出结论：可以实现，但这种模式确实不符合Gradle推荐的最佳实践，下面详细说明细节：

一、如何实现你的需求 #

Gradle默认的doLast块无法直接获取单个输入的过期状态，但可以通过自定义增量Task来实现这个逻辑。Gradle提供了IncrementalTaskInputs接口，允许你识别哪些输入文件发生了变化，从而分支执行不同的逻辑。

示例代码（Groovy DSL） #

abstract class ProcessFilesTask extends DefaultTask {
    // 定义输入文件
    @InputFile
    RegularFileProperty file1 = project.objects.fileProperty().set(project.file("file1.log"))

    @InputFile
    RegularFileProperty file2 = project.objects.fileProperty().set(
        project.findProperty("file2.log") ? project.file(project.findProperty("file2.log")) : null
    )

    // 定义输出文件
    @OutputFile
    RegularFileProperty outputFile = project.objects.fileProperty().set(project.file("file3.log"))

    @TaskAction
    void execute(IncrementalTaskInputs inputs) {
        boolean file1Changed = false
        boolean file2Changed = false

        // 遍历所有过期的输入，标记哪些文件发生了变化
        inputs.outOfDate { change ->
            def changedFile = change.file
            if (changedFile == file1.get().asFile) {
                file1Changed = true
            } else if (changedFile == file2.get().asFile) {
                file2Changed = true
            }
        }

        // 如果是首次执行（无增量信息），直接全量处理
        if (!inputs.incremental) {
            processFile1AndFile2()
            return
        }

        // 根据输入变化情况分支执行
        if (file1Changed) {
            processFile1AndFile2()
        } else if (file2Changed) {
            onlyProcessFile2()
        }
    }

    // 全量处理逻辑
    private void processFile1AndFile2() {
        println "Processing both file1 and file2"
        outputFile.get().asFile.text = "Processed both at: ${new Date()}"
    }

    // 仅处理file2的逻辑
    private void onlyProcessFile2() {
        println "Only processing file2"
        outputFile.get().asFile.text += "\nProcessed file2 at: ${new Date()}"
    }
}

// 注册自定义Task
tasks.register('printIsSpecificInputUpToDate', ProcessFilesTask)

代码说明 #

• 自定义Task通过@InputFile和@OutputFile注解声明输入输出，让Gradle能追踪它们的状态变化。
• IncrementalTaskInputs的outOfDate方法会遍历所有过期的输入文件，我们可以在这里标记哪些文件发生了变化。
• 如果是首次执行（inputs.incremental为false），没有增量信息，直接执行全量处理逻辑。

二、为什么Gradle不推荐这种模式 #

虽然能实现，但这种在单个Task内分支处理的方式属于不良实践，原因如下：

• 违反单一职责原则：一个Task应该只做一件明确的事，这样Gradle的增量构建、缓存和并行执行才能发挥最大效用。拆分Task后，Gradle可以更精细地控制哪些部分需要重新执行，还能单独缓存每个Task的输出。
• 增加复杂度：手动处理增量逻辑会让Task变得更难调试和维护，你需要自己处理各种边界情况（比如首次执行、多个输入同时变化等），而Gradle原本可以自动处理这些。
• 破坏构建可预测性：这种分支逻辑会让Task的行为变得不透明，其他开发者很难快速理解构建流程，也容易引入隐藏的bug。

更优的替代方案 #

推荐将逻辑拆分为多个独立的Task：

1. 创建processFile1 Task，负责处理file1.log并生成一个中间输出。
2. 创建processFile2 Task，负责处理file2.log并生成另一个中间输出。
3. 创建mergeOutputs Task，依赖前两个Task的输出，合并生成最终的file3.log。

这样Gradle会自动处理每个Task的增量状态，只重新执行过期的Task，既符合Gradle的设计理念，又能达到同样的效果。

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