InputChanges

属性
方法
脚本块
属性详情
方法详情

API 文档	`InputChanges`

提供对增量工作操作需要处理的任何输入文件的访问。

增量工作操作是指接受单个 InputChanges 参数的操作。工作操作可以查询自上次执行以来输入参数的更改，以便仅处理更改。以下示例显示了一个任务，该任务反转其每个输入文件中的文本。它演示了如何使用 InputChanges 仅处理更改的文件。

abstract class IncrementalReverseTask extends DefaultTask {
    @Incremental
    @InputDirectory
    abstract DirectoryProperty getInputDir()

    @OutputDirectory
    abstract DirectoryProperty getOutputDir()

    @TaskAction
    void execute(InputChanges inputChanges) {
        inputChanges.getFileChanges(inputDir).each { change ->
            if (change.fileType == FileType.DIRECTORY) return

            def targetFile = outputDir.file(change.normalizedPath).get().asFile
            if (change.changeType == ChangeType.REMOVED) {
                targetFile.delete()
            } else {
                targetFile.text = change.file.text.reverse()
            }
        }
    }
}

如果 Gradle 无法确定哪些输入文件需要重新处理，则所有输入文件都将报告为 ChangeType.ADDED。当发生此类完全重建时，将在执行工作操作之前删除工作的输出文件。发生这种情况的情况包括

没有来自先前执行的历史记录。
自上次执行以来，非文件输入参数已更改。
自上次执行以来，一个或多个输出文件已更改。

属性

属性	描述
`incremental`	指示 Gradle 是否可以确定哪些输入文件相对于先前的执行已过期。当历史记录不可用（即，此工作项以前从未执行过），或者非文件输入属性或输出文件发生更改时，增量输入不可用。

方法

方法	描述
`getFileChanges(parameter)`	参数的更改。
`getFileChanges(parameter)`	参数的更改。

脚本块

没有脚本块

属性详情

`boolean` `incremental` (只读)

指示 Gradle 是否可以确定哪些输入文件相对于先前的执行已过期。当历史记录不可用（即，此工作项以前从未执行过），或者非文件输入属性或输出文件发生更改时，增量输入不可用。

当 true 时

InputChanges.getFileChanges(org.gradle.api.file.FileCollection) 和 InputChanges.getFileChanges(org.gradle.api.provider.Provider) 报告与先前执行相比输入文件的更改。

当 false 时

每个输入文件都通过 InputChanges.getFileChanges(org.gradle.api.file.FileCollection) 和 InputChanges.getFileChanges(org.gradle.api.provider.Provider) 报告，就像它是 ChangeType.ADDED 一样。

方法详情

`Iterable<FileChange>` `getFileChanges`(`FileCollection` 参数)

参数的更改。

当 InputChanges.isIncremental() 为 false 时，参数的所有元素都将作为 ChangeType.ADDED 返回。

只有使用 @Incremental 或 @SkipWhenEmpty 注解的输入文件属性才能查询更改。

请注意，对于具有 PathSensitivity.NONE 的输入，文件修改可以报告为 ChangeType.ADDED 和 ChangeType.REMOVED 事件对，而不是 ChangeType.MODIFIED 事件。

`Iterable<FileChange>` `getFileChanges`(`Provider<? extends FileSystemLocation>` 参数)