如何从Gradle向Android Manifest注入tools:node值及解决配置失效问题

这个问题我之前也碰到过，核心原因是Android Gradle插件默认只会对Android命名空间（android:开头）的属性做manifestPlaceholders替换，像tools:这种属于工具命名空间的属性，插件不会自动处理占位符，所以你直接写tools:node="${appWidget}"会被当成字面量，导致Manifest解析报错。下面给你两种可行的解决方案：

方法一：用Gradle Manifest合并规则（推荐） #

不用在Manifest里写占位符，直接在Gradle中根据条件配置Manifest合并时的移除规则，这是官方推荐的更可靠的方式：

android {
    // 其他现有配置...
    
    // 读取环境变量，默认值为true
    def hasWidget = Boolean.valueOf(System.env.hasWidget ?: true)
    
    if (!hasWidget) {
        manifestMerger {
            mergeRules {
                // 用XPath定位要移除的receiver，注意替换成你实际的Receiver完整类名
                remove("application/receiver[@android:name='com.yourpackage.YourWidgetReceiver']")
            }
        }
    }
}

这样当hasWidget为false时，Gradle会在Manifest合并阶段自动移除指定的receiver元素，完全不需要在Manifest里写tools:node。

方法二：自定义Manifest模板生成 #

如果你一定要通过占位符替换tools:node的值，可以用Groovy模板引擎手动生成Manifest文件：

1. 把原src/main/AndroidManifest.xml重命名为AndroidManifest.xml.template，把里面的tools:node改成占位符：

<receiver 
    android:name="com.yourpackage.YourWidgetReceiver" 
    tools:node="${appWidget}" 
    android:label="....">
    <!-- 其他内容 -->
</receiver>

2. 在app模块的build.gradle中添加预构建任务，负责生成最终的Manifest：

android {
    // 其他现有配置...
    
    def hasWidget = Boolean.valueOf(System.env.hasWidget ?: true)
    def appWidgetValue = hasWidget ? "replace" : "remove"
    
    preBuild.doFirst {
        def templateFile = file('src/main/AndroidManifest.xml.template')
        def manifestFile = file('src/main/AndroidManifest.xml')
        // 用Groovy模板引擎替换占位符
        def template = new groovy.text.SimpleTemplateEngine().createTemplate(templateFile.text)
        def manifestContent = template.make([appWidget: appWidgetValue])
        manifestFile.write(manifestContent.toString())
    }
}

每次构建前，这个任务会自动根据hasWidget的值替换模板中的占位符，生成正确的Manifest文件。

注意事项 #

• 方法一中的XPath要精准匹配目标元素，比如android:name必须写完整的类名，避免误删其他receiver；
• 方法二要确保模板文件路径正确，同时如果有多渠道或Build Variant，可能需要调整模板的读取逻辑。

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