Gradle Tooling API能否更新依赖并生成更新后的build.gradle文件？

核心结论 #

Gradle Tooling API不支持将内存中修改的依赖模型直接写回原始build.gradle文件。这个API的设计定位是读取构建模型、执行构建任务，而非逆向生成符合Groovy/Kotlin DSL语法的构建脚本文本——它拿到的是构建执行后抽象化的依赖对象，已经脱离了原始脚本的语法结构（不管依赖是字符串还是Map格式），无法自动映射回合法的脚本内容。

针对发布流程的替代方案 #

你的需求是发布内部模块后批量更新依赖该模块的其他项目版本，推荐以下两种更可靠的方案：

方案1：改用集中式版本管理（优先推荐） #

重构项目的版本管理方式，把依赖版本统一集中维护，避免逐个修改build.gradle：

• 使用Gradle官方推荐的version catalog：在settings.gradle[.kts]中引入libs.versions.toml文件，将所有依赖的版本号定义在这个文件里，build.gradle中通过libs.group.module的方式引用依赖。更新版本时只需要修改toml文件中的对应版本值，用Java读取修改这个纯文本toml文件非常简单，完全不用处理复杂的DSL语法。
• 或者在根项目的build.gradle中定义ext全局变量，子项目直接引用变量值，更新时仅修改根项目的变量即可。

方案2：用AST解析库修改构建脚本（替代正则） #

如果必须直接修改build.gradle文件，不要自己写正则表达式（容易出错），使用专门处理Groovy/Kotlin AST的库来解析和修改脚本：

• Groovy DSL脚本修改：借助org.codehaus.groovy:groovy的AST API，解析build.gradle的语法树，精准定位依赖节点修改版本号，再生成合法的Groovy代码写回文件。
• Kotlin DSL脚本修改：使用org.jetbrains.kotlin:kotlin-compiler的AST工具，或者专门的Gradle Kotlin DSL AST库处理。

以下是Groovy AST修改依赖的核心示例代码：

// 读取目标build.gradle文件
def buildFile = new File("./build.gradle")
def ast = new GroovyShell().parse(buildFile)

// 遍历语法树，找到dependencies块并修改指定依赖版本
ast.statements.each { stmt ->
    if (stmt instanceof MethodCallExpression && stmt.methodAsString == "dependencies") {
        stmt.arguments.each { depBlock ->
            depBlock.statements.each { depStmt ->
                if (depStmt instanceof MethodCallExpression) {
                    // 处理字符串格式的依赖（如implementation 'com.yourcompany:internal-module:1.2.2'）
                    def args = depStmt.arguments
                    if (args[0] instanceof ConstantExpression) {
                        def depStr = args[0].value.toString()
                        if (depStr.startsWith("com.yourcompany:internal-module:")) {
                            args[0].value = "com.yourcompany:internal-module:1.2.3" // 替换为新版本
                        }
                    }
                    // 处理Map格式的依赖（如implementation group: 'com.yourcompany', name: 'internal-module', version: '1.2.2'）
                    else if (args[0] instanceof MapExpression) {
                        args[0].mapEntryExpressions.each { entry ->
                            if (entry.keyExpression.value == "version" && entry.valueExpression.value == "1.2.2") {
                                entry.valueExpression.value = "1.2.3" // 替换为新版本
                            }
                        }
                    }
                }
            }
        }
    }
}

// 将修改后的语法树写回文件
buildFile.text = ast.toString()

总结 #

• 放弃用Gradle Tooling API写回build.gradle的想法，它不具备这个能力。
• 优先采用集中式版本管理，从根源上减少脚本修改的工作量。
• 必须修改脚本时，用AST解析库替代正则，能正确处理不同格式的依赖定义，避免语法错误。

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