Gradle需借助Groovy/Kotlin或Java库解析修改XML,推荐用Groovy的XmlSlurper:编写自定义任务→加载XML→解析→修改节点/属性→序列化回写。

Gradle 本身不内置 XML 解析和修改功能,但可以借助 Groovy(默认 DSL)或 Kotlin 的原生 XML 支持,结合 Java 标准库(如 DOM、SAX、StAX)或第三方库(如 XmlSlurper、XmlParser)来完成。关键在于:在 Gradle 构建脚本中编写自定义任务,加载 XML 文件 → 解析 → 修改节点/属性 → 序列化回文件。
使用 Groovy 的 XmlSlurper(推荐,简洁易读)
XmlSlurper 是 Groovy 提供的轻量级、面向路径的 XML 解析器,适合读写中小型 XML 文件(如 AndroidManifest.xml、pom.xml、自定义配置)。它支持链式操作和 GPath 表达式,修改后可直接用 XmlSerializer 写出。
- 在
build.gradle中添加任务:
if (!file.exists()) return
// 解析
def xml = new XmlSlurper().parse(file)
// 修改:设置 root 属性
xml.@version = "2.1"
// 修改:更新某个节点文本
xml.'**'.find { it.name() == 'app-name' }?.value = "MyApp-Prod"
// 修改:添加新子节点
xml.appendNode {
debugMode("true")
}
// 写回文件(保留缩进需用 StreamingMarkupBuilder 或 XmlSerializer)
def writer = new FileWriter(file)
def printer = new XmlNodePrinter(new PrintWriter(writer))
printer.print(xml)
}
使用 Java DOM(适合复杂逻辑与标准兼容)
当需要精确控制命名空间、DOCTYPE、CDATA 或需与 Java 工具链对齐时,用 Java DOM API 更稳妥。Gradle 脚本中可直接调用 DocumentBuilder,注意需手动处理异常和资源关闭。
- 示例:更新
的值
def factory = javax.xml.parsers.DocumentBuilderFactory.newInstance()
def builder = factory.newDocumentBuilder()
def doc = builder.parse(file)
doc.documentElement.setAttribute("updated", "true")
// 查找所有 property 元素并修改 timeout
def nodes = doc.getElementsByTagName("property")
(0..
if (nodes.item(i).getAttribute("name") == "timeout") {
nodes.item(i).textContent = "30000"
}
}
// 写出(带格式化)
def transformer = javax.xml.transform.TransformerFactory.newInstance().newTransformer()
transformer.setOutputProperty(javax.xml.transform.OutputKeys.INDENT, "yes")
transformer.setOutputProperty("{http://xml.apache.org/xslt}indent-amount", "2")
def result = new javax.xml.transform.stream.StreamResult(file)
transformer.transform(new javax.xml.transform.dom.DOMSource(doc), result)
}
注意事项与常见坑
实际使用中容易忽略以下细节,导致修改失败或格式错乱:
威流淘宝客返现程序(淘客返利) v4.0更新内容: 将网站编码改为utf-8 修改后台不能导入报表 淘宝客返现程序(淘客返利)整合支付宝用户登录,注册会员可以推广本网站。用户登录后自动返现。 威流淘宝客返现程序(淘客返利)安装 解压文件传至服务器FTP目录下wwwroot目录, 如果放在子目录,请将该目录(如fanxian)设置为虚拟目录, 或者直接将bin目录和web.config放至网站根目录
-
编码问题:读写 XML 时显式指定 UTF-8(尤其是含中文),避免乱码:
new FileReader(file, "UTF-8")/new FileWriter(file, "UTF-8") -
命名空间(namespace):XmlSlurper 默认忽略 namespace;若 XML 含
xmlns,需用new XmlSlurper(false, false)并配合declareNamespace() -
空白节点干扰:DOM 中文本节点可能包含换行和缩进,用
node.getTextContent().trim()安全取值 -
增量构建兼容性:将 XML 修改任务标记为
inputs.file和outputs.file,避免重复执行
扩展建议:封装为可复用插件
如果多个项目都需要类似能力(如自动注入版本号、开关 debug 标志),可把逻辑封装成自定义 Gradle 插件,暴露简单 DSL:
xmlModifier {sourceFile = file("manifest.xml")
updateAttribute "manifest", "@android:versionName", project.version
updateText "application/meta-data[@name='build-time']", new Date().toString()
}
这样既提升复用性,又保持构建脚本干净。









