Gradle条件调用任务最佳实践：如何实现build按需执行taskA或taskB

问题背景 #

已注册两个任务：

tasks.register('taskA') {
  // 执行操作
}

tasks.register('taskB') {
  // 执行其他操作
}

希望调用build任务时，根据条件决定触发taskA或taskB，但Gradle没有execute()方法，且希望尽量避免直接使用dependsOn，该如何实现？

最佳实践方案 #

Gradle的任务执行依赖任务图构建机制，不能在任务的执行阶段（比如doLast块）动态触发其他任务，必须在配置阶段就确定任务间的关系。以下是几种合规的实现方式：

方案1：用finalizedBy结合条件动态配置 #

如果希望build任务执行完成后自动触发目标任务，可在配置阶段为build动态设置finalizedBy（finalizedBy表示当前任务执行完成后自动执行指定任务，比硬编码执行逻辑更符合Gradle任务模型）：

// 替换为你的实际条件判断逻辑
def condition = true 

tasks.named('build') {
    if (condition) {
        finalizedBy('taskA')
    } else {
        finalizedBy('taskB')
    }
}

方案2：创建中间调度任务 #

把条件判断逻辑封装到单独的调度任务中，再让build依赖该调度任务，代码结构更清晰：

def condition = true

// 调度任务根据条件决定依赖的目标任务
tasks.register('dispatchTask') {
    dependsOn condition ? 'taskA' : 'taskB'
}

// build执行完成后触发调度任务
tasks.named('build') {
    finalizedBy('dispatchTask')
}

方案3：基于外部参数动态配置 #

如果条件需要通过命令行参数等外部输入控制，可使用Gradle的Provider机制延迟判断：

// 从命令行参数读取条件，比如执行 ./gradlew build -PrunTask=A
def condition = providers.systemProperty('runTask').forUseAtConfigurationTime()

tasks.named('build') {
    finalizedBy(condition.map { it == 'A' ? tasks.named('taskA') : tasks.named('taskB') })
}

关键注意点 #

• 绝对不要在doLast/doFirst等执行阶段代码中尝试触发其他任务，这会破坏Gradle任务图的一致性，引发不可预测的问题。
• 所谓“避免使用dependsOn”是指避免滥用硬编码的固定依赖，结合条件动态配置依赖完全符合Gradle最佳实践。

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