如何在Kotlin DSL中配置gradle-download-plugin的下载解压任务？

一、下载任务的正确性说明 #

原Groovy下载任务代码：

task downloadZipFile(type: Download) {
    src 'https://github.com/michel-kraemer/gradle-download-task/archive/refs/tags/5.5.0.zip'
    dest layout.buildDirectory.file('5.5.0.zip')
}

你编写的Kotlin DSL代码存在一处细节差异需要注意：

task<Download>("downloadZipFile") {
    src("https://services.gradle.org/distributions/gradle-8.6-bin.zip")
    dest(project.layout.buildDirectory.dir("gradle-dists"))
}

原Groovy任务中dest指定的是单个具体文件路径，而你的Kotlin代码用dir("gradle-dists")指定的是一个目录。这会导致下载的文件被放到gradle-dists目录下，自动使用原URL中的文件名（即gradle-8.6-bin.zip），而非像Groovy示例那样自定义文件名。如果你的需求是将文件下载到指定目录，这个写法没问题；如果需要指定具体文件名，应修改为：

dest(project.layout.buildDirectory.file("gradle-dists/gradle-8.6-bin.zip"))

二、解压任务的完整Kotlin DSL转换（含依赖声明） #

关于dependsOn: downloadZipFile的转换，在Kotlin DSL中直接在任务配置块内调用dependsOn()方法即可。同时要注意Gradle的延迟配置特性，直接引用任务对象可能出现初始化顺序问题，更稳妥的方式是通过tasks.named()获取任务并映射其属性。完整的解压任务写法如下：

task<Copy>("downloadAndUnzipFile") {
    // 添加任务依赖
    dependsOn("downloadZipFile")
    // 安全获取下载任务的目标文件并创建zipTree
    from(tasks.named<Download>("downloadZipFile").map { zipTree(it.dest) })
    into(layout.buildDirectory)
}

如果任务定义在同一个脚本中，也可以用tasks.downloadZipFile简化写法，但named()+map()的方式更通用，适用于跨脚本引用任务的场景。

三、通过官方文档解决这类问题的方法 #

1. Gradle Kotlin DSL迁移指南：官方提供了Groovy到Kotlin DSL的语法对比文档，涵盖任务定义、依赖声明、属性访问等核心差异，是语法迁移的首选参考。
2. 插件官方文档：gradle-download-task这类第三方插件，通常会在文档中提供Kotlin DSL的示例代码，直接查看插件文档就能找到对应写法。
3. Gradle内置报告：在项目根目录执行命令gradle kotlinDslAccessorsReport，生成的报告会列出当前项目可用的任务、属性的Kotlin访问方式，能快速解决属性引用问题。
4. Gradle核心API文档：查看Copy、Download等任务类的官方API文档，了解方法参数和返回值，Kotlin的调用逻辑和Groovy一致，仅需补全括号、处理延迟属性即可。

内容的提问来源于stack exchange，提问作者René Link