Gradle通过processResources过滤、manifestPlaceholders（Android专用）或自定义Copy任务实现XML占位符${key}替换；需注意转义（$$）、属性作用域及XML合法性校验。
Gradle 本身不直接解析或替换 XML 文件中的占位符（如 ${name}），但可以通过多种方式在构建过程中实现 XML 占位符的替换，核心思路是：把 XML 当作资源文件处理，在打包（如生成 APK、JAR 或 WAR）前用 Gradle 的资源过滤机制或自定义任务完成替换。
使用 processResources 任务做资源过滤
这是最常用、最轻量的方式，适用于 src/main/resources 下的 XML（比如配置文件、Spring bean 定义等）。Gradle 的 processResources 默认支持属性替换，只需启用过滤并提供属性源。
- 在
build.gradle中配置：
processResources {
filesMatching('**/*.xml') {
expand(project.properties) // 替换 ${key} 为 project.property('key')
}
}
</font>
<ul>
<li>确保占位符写法匹配 Groovy 字符串插值风格（即 <code>${key}</code>，不是 <code>@key@</code> 或 <code>#{key}</code>）</li>
<li>在命令行传入属性：<code>./gradlew build -PappVersion=1.2.3</code>，XML 中的 <code>${appVersion}</code> 就会被替换成 <code>1.2.3</code></li>
<li>也可用 <code>ext</code> 预定义属性：<code>ext.apiHost = "https://api.example.com"</code>，然后在 XML 中写 <code>${apiHost}</code></li>
</ul>
<H3>对 Android 项目：用 manifestPlaceholders + AndroidManifest.xml</H3>
<p>Android Gradle 插件专门支持 <code>AndroidManifest.xml</code> 中的占位符，语法是 <code>${APP_NAME}</code>，需通过 <code>manifestPlaceholders</code> 注入。</p><div class="aritcle_card flexRow">
<div class="artcardd flexRow">
<a class="aritcle_card_img" href="/ai/2127" title="Amazon Nova"><img
src="https://img.php.cn/upload/ai_manual/000/000/000/175679969158525.png" alt="Amazon Nova" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
<div class="aritcle_card_info flexColumn">
<a href="/ai/2127" title="Amazon Nova">Amazon Nova</a>
<p>亚马逊云科技（AWS）推出的一系列生成式AI基础模型</p>
</div>
<a href="/ai/2127" title="Amazon Nova" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a>
</div>
</div>
<ul>
<li>在 <code>android.defaultConfig</code> 或 <code>buildTypes</code> 中设置：</li>
</ul>
<font color="#888">
<pre class="brush:php;toolbar:false;">
android {
defaultConfig {
manifestPlaceholders = [appName: "MyApp", versionCode: 42]
}
buildTypes {
release {
manifestPlaceholders += [trackingEnabled: "true"]
}
}
}
- 在
AndroidManifest.xml中使用：android:label="${appName}"或meta-data android:value="${trackingEnabled}" - 注意：只对
AndroidManifest.xml生效，且仅限该文件；其他 XML（如 res/xml/）不走这套机制
自定义 Copy 任务处理任意 XML 文件
当 XML 不在标准资源路径（如放在 config/ 目录下），或需要更灵活控制（比如多环境模板、保留原始文件），可写一个 Copy 任务。
- 示例：从
src/config/template.xml复制并替换后输出到build/config/app.xml
task generateConfigXml(type: Copy) {
from 'src/config/template.xml'
into 'build/config'
expand(
appName: project.findProperty('appName') ?: 'DevApp',
env: project.findProperty('env') ?: 'dev'
)
}
- 用
expand()替换${appName}；用findProperty()安全读取参数，避免未定义时报错 - 让其他任务依赖它：
classes.dependsOn generateConfigXml)，确保生成时机正确
注意事项与常见问题
占位符替换看着简单，但容易踩坑：
