如何将Android Manifest的meta-data占位符设为可选避免合并报错

方案1：Manifest占位符设置默认值（推荐，适配AGP 7.0+） #

直接在AndroidManifest.xml中给占位符添加默认值，无需修改Gradle配置，缺失占位符时会自动使用默认值：

<meta-data
    android:name="developer_mode"
    android:value="${DeveloperMode:false}"
    tools:node="merge"/>

语法为${占位符名:默认值}，AGP 7.0及以上版本原生支持，完全避免占位符缺失导致的合并报错。

方案2：模块Gradle添加兜底占位符（兼容低版本AGP） #

在你的模块级build.gradle中提前判断占位符是否存在，不存在时自动插入默认值：

android {
    defaultConfig {
        // 其他原有配置
        if (!manifestPlaceholders.containsKey('DeveloperMode')) {
            manifestPlaceholders.put('DeveloperMode', 'false')
        }
    }
}

该方案兼容所有AGP版本，上层项目删除对应配置后，模块会自动补全默认值，不会触发报错。

方案3：改用BuildConfig传递开关（适合代码内部调用） #

如果该开关仅在模块代码内部使用，无需写入Manifest，可改用BuildConfig变量传递，灵活度更高：

1. 模块级build.gradle添加如下配置：

android {
    defaultConfig {
        // 其他原有配置
        def devModeDefault = project.hasProperty('DeveloperMode') ? project.getProperty('DeveloperMode') : 'false'
        buildConfigField "boolean", "DEVELOPER_MODE", devModeDefault
    }
}

2. 上层项目需要自定义开关时，只需在项目根目录的gradle.properties中添加配置即可：

DeveloperMode=true

3. 代码中直接读取即可：

if (BuildConfig.DEVELOPER_MODE) {
    // 开发者模式逻辑
}

该方案完全不涉及Manifest占位符，不存在合并报错问题，支持布尔、整数等多种数据类型，无需手动做类型转换。

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