Gradle复合构建按指定顺序执行release任务失败求助

我有一个Gradle复合构建，目录结构如下：

.
├── component-1
├── component-2
├── component-3
└── composite-build

所有组件均为多项目构建，且各自集成了release插件可单独发布。composite-build的settings.gradle配置如下：

rootProject.name = 'composite-build'

includeBuild '../component-1'
includeBuild '../component-2'
includeBuild '../component-3'

我希望按指定顺序执行各组件的release任务，但尝试了两种方案均失败，且因release插件的Git标签提交冲突导致单个release任务也失败。

尝试案例1：直接依赖所有组件release任务 #

在build.gradle中定义releaseAll任务依赖各组件的release任务：

task releaseAll {
    dependsOn gradle.includedBuild('component-1').task(':release')
    dependsOn gradle.includedBuild('component-2').task(':release')
    dependsOn gradle.includedBuild('component-3').task(':release')
}

尝试案例2：拆分任务并设置执行顺序 #

拆分任务并通过mustRunAfter设置顺序：

task releaseComponent1 {
    dependsOn gradle.includedBuild('component-1').task(':release')
}

task releaseComponent2 {
    dependsOn gradle.includedBuild('component-2').task(':release')
}

task releaseComponent3 {
    dependsOn gradle.includedBuild('component-3').task(':release')
}

releaseComponent2.configure {
    mustRunAfter releaseComponent1
}

releaseComponent3.configure {
    mustRunAfter releaseComponent2
}

task releaseAll {
    dependsOn releaseComponent1
    dependsOn releaseComponent2
    dependsOn releaseComponent3
}

错误信息示例 #

> Task :component-1:component-1-release:preTagCommit FAILED
Running [git, commit, -m,  [Gradle Release Plugin] - pre tag commit:  'component-1-0.1.10'., -a] produced an error: []
Running [git, push, --porcelain, origin, main] produced an error: [error: failed to push some refs to 'https://github.com/<username>/<repo-name>.git']

> Task :component-1:release FAILED
Release process failed, reverting back any changes made by Release Plugin.
Running [git, checkout, gradle.properties] produced an error: [error: pathspec 'gradle.properties' did not match any file(s) known to git]

1: Task failed with an exception.
-----------
* What went wrong:
Execution failed for task ':component-1:component-1-release:preTagCommit'.
> Failed to push to remote - [To https://github.com/<username>/<repo-name>.git
  !     refs/heads/main:refs/heads/main [remote rejected] (cannot lock ref 'refs/heads/main': is at <xxxx> but expected <yyyy>)
  Done
  ][error: failed to push some refs to 'https://github.com/<username>/<repo-name>.git'
  ]

现寻求正确实现按指定顺序执行各组件release任务的方法。

1. 先修复Git冲突根源 #

错误核心是本地分支与远程分支状态不一致，release插件执行时会修改版本文件并推送，若本地落后于远程就会触发推送失败。

• 进入每个组件目录，执行git pull origin main（替换为你的实际分支名），确保本地分支与远程同步
• 确认每个组件的gradle.properties（或版本配置文件）已被Git跟踪，执行git add gradle.properties && git commit -m "Track version file"（若未跟踪）

2. 正确设置复合构建任务的执行顺序 #

在复合构建中，对包装任务设置mustRunAfter无法直接约束包含构建的任务，需要直接对包含构建的任务实例设置顺序：
修改composite-build/build.gradle如下：

// 获取各组件的release任务实例
def releaseTask1 = gradle.includedBuild('component-1').task(':release')
def releaseTask2 = gradle.includedBuild('component-2').task(':release')
def releaseTask3 = gradle.includedBuild('component-3').task(':release')

// 设置严格的串行执行顺序
releaseTask2.mustRunAfter releaseTask1
releaseTask3.mustRunAfter releaseTask2

// 定义统一的release入口任务
task releaseAll {
    dependsOn releaseTask1, releaseTask2, releaseTask3
}

这种方式直接对包含构建的任务设置顺序约束，Gradle会严格按指定顺序执行每个组件的release流程。

3. 禁用并行执行避免Git冲突 #

复合构建默认可能启用并行执行，会导致多个组件同时操作Git仓库引发冲突。在composite-build/gradle.properties中添加：

org.gradle.parallel=false

强制所有任务串行执行，彻底避免多组件同时修改Git仓库的问题。

4. 修复release插件回滚异常 #

错误中出现的git checkout gradle.properties失败，是因为插件回滚时找不到该文件。确保：

• 每个组件的根目录或子项目中存在gradle.properties，且已被Git跟踪
• 若使用自定义版本配置文件，需在release插件配置中指定该文件路径，避免回滚时找不到目标文件

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