Gradle中build.gradle出现‘无法应用’警告的解决方法咨询

问题 #

我尝试创建一个处理Node项目文件的Gradle任务，当前代码如下：

tasks.register('buildUi', Exec) { task ->
    task.workingDir = uiProjectDir
    task.inputs.dir("${uiProjectDir}/src")
    task.inputs.dir("${uiProjectDir}/node_modules")
    task.outputs.dir(uiDistDir)
    task.dependsOn tasks.named('npmInstall')

    // Use bash directly when in WSL
    task.commandLine 'bash', '-c', 'npm run build'
}

运行时出现两个警告：

• 第一行的'register' cannot be applied to '(java.lang.String, java.lang.Class<org.gradle.api.tasks.Exec>, groovy.lang.Closure)'
• task.dependsOn tasks.named('npmInstall')行的'named' cannot be applied to '(java.lang.String)'

我尝试了Copilot给出的task.dependsOn tasks.getByName('npmInstall')和tasks.register('buildUi', Exec).configure { task -> }方案，以及去掉lambda表达式的写法，但警告仍存在。

我的Gradle环境信息如下：

------------------------------------------------------------
Gradle 8.10.2
------------------------------------------------------------

Build time:    2024-09-23 21:28:39 UTC
Revision:      415adb9e06a516c44b391edff552fd42139443f7

Kotlin:        1.9.24
Groovy:        3.0.22
Ant:           Apache Ant(TM) version 1.10.14 compiled on August 16 2023
Launcher JVM:  23 (Oracle Corporation 23+37-2369)
Daemon JVM:    /home/jgleason/lib/java/jdk-23 (no JDK specified, using current Java home)
OS:            Linux 5.15.153.1-microsoft-standard-WSL2 amd64

请问正确的写法是什么才能消除这些警告？

解决方案 #

针对Gradle 8.x的Groovy DSL，调整任务注册和依赖引用方式即可消除警告，以下是正确写法：

tasks.register('buildUi', Exec) {
    workingDir = uiProjectDir
    inputs.dir("${uiProjectDir}/src")
    inputs.dir("${uiProjectDir}/node_modules")
    outputs.dir(uiDistDir)
    // 明确指定tasks.named的泛型类型，解决方法调用类型不匹配问题
    dependsOn tasks.named('npmInstall', Task)

    // WSL环境下直接调用bash执行构建命令
    commandLine 'bash', '-c', 'npm run build'
}

关键调整点： #

1. 简化闭包参数：Groovy DSL中可省略task ->参数，闭包内直接使用隐式委托对象（当前任务实例），避免类型匹配警告。
2. 指定tasks.named泛型：Gradle 8.x要求tasks.named()明确泛型类型（这里指定为Task），也可以直接用字符串形式dependsOn 'npmInstall'，两种方式都能解决named方法的类型警告。
3. 链式调用替代方案：若偏好链式写法，也可使用configure方法，同样能规避类型问题：

tasks.register('buildUi', Exec).configure {
    workingDir = uiProjectDir
    inputs.dir("${uiProjectDir}/src")
    inputs.dir("${uiProjectDir}/node_modules")
    outputs.dir(uiDistDir)
    dependsOn tasks.named('npmInstall', Task)
    commandLine 'bash', '-c', 'npm run build'
}

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