Gradle zipTree结合singleFile编译失败问题咨询及解决方法

Gradle的构建流程分为配置阶段和执行阶段，这两个阶段的执行时机是导致差异的核心：

• 你的第一个写法里，.matching { include '**/bar.h' }.singleFile 是立即求值的逻辑——在Gradle加载编译脚本的配置阶段，它就会尝试读取foo.zip的内容，试图找到匹配的bar.h并返回文件对象。但这时候zip文件还没从外部仓库拉取到本地，自然会抛出文件不存在的错误。
• 第二个写法则完全不同：zipTree("foo.zip") 只是创建了一个懒加载的文件树提供者，它不会在配置阶段就解析zip内容，而是等到任务真正执行（执行阶段）的时候才会去读取文件。这时候zip已经下载完成，所以能正常工作。

下面提供两种靠谱的实现方式，都能避免配置阶段的提前解析问题：

方案1：在zipTree闭包里直接过滤 #

把过滤逻辑放到zipTree的配置闭包里，Gradle会延迟到执行阶段再处理过滤和文件提取：

task unzip_foo_bar(type: Copy) {
    from zipTree("foo.zip") {
        include '**/bar.h'
    }
    into "build"
}

这种写法最简洁，本质是让过滤规则成为zipTree的一部分，而非在配置阶段立即计算结果。

方案2：用Provider延迟求值 #

如果必须明确获取单个文件对象（比如后续要对这个文件做额外操作），可以用Gradle的Provider API把求值逻辑延迟到执行阶段：

task unzip_foo_bar(type: Copy) {
    // 用provider包装，里面的代码只会在执行阶段运行
    def targetFile = project.provider {
        zipTree("foo.zip").matching { include '**/bar.h' }.singleFile
    }
    from targetFile
    into "build"
}

Provider就像一个“延迟执行的容器”，只有当任务真正需要用到targetFile的时候，才会执行里面的代码去读取zip文件，这时候zip已经就位了。

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