如何根据Android API级别差异化配置AndroidManifest的meta-data

你之前的方案不生效是两个核心原因：

• <meta-data>标签本身不支持android:enabled属性，这个属性是给Activity、Service、BroadcastReceiver、ContentProvider这四大组件用的，写在meta-data节点上系统直接忽略，根本不会起任何开关作用。
• 资源限定目录的版本号没对应对：如果要卡API 30的阈值，对应目录是values-v30，你建的values-v31是给API 31（Android 12）及以上版本用的，版本差了一级，自然匹配不上。

方案1：版本差异化资源赋值（最通用，推荐优先用） #

如果你的需求只是旧版本下这个配置值为true、高版本下为false，不需要让meta-data节点在高版本完全消失，直接给meta-data的value引用分版本的布尔资源就行，完全不用绕enabled的逻辑。
操作步骤：

• 默认的res/values/bools.xml里配旧版本的默认值：

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <bool name="disable_batch_scanning">true</bool>
</resources>

• 新建对应高版本阈值的资源目录，比如要让API >=30时配置失效，就建res/values-v30/bools.xml，里面配高版本的值：

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <bool name="disable_batch_scanning">false</bool>
</resources>

• Manifest里的meta-data直接引用这个布尔值：

<meta-data 
    android:name="disable_batch_scanning" 
    android:value="@bool/disable_batch_scanning" />

系统会在应用安装时根据当前设备的API级别自动匹配对应资源目录下的值，不需要额外写任何代码处理。

方案2：构建时按版本移除meta-data节点（适配特殊SDK逻辑） #

有些第三方SDK的判断逻辑很死：只要Manifest里存在这个meta-data节点，不管value是true还是false都会触发对应逻辑。这种场景需要让高版本的Manifest里根本没有这个节点，可以靠Manifest合并规则实现：

1. 先在Manifest根节点加上tools命名空间声明：

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    ...>

2. 给meta-data节点加上版本限定，让它只在低版本构建时被打包进去：

<meta-data 
    android:name="disable_batch_scanning" 
    android:value="true"
    tools:targetApi="29" />

tools:targetApi="29"的作用是告诉Manifest合并工具：这个节点仅在API <=29（Android 10及以下）的构建变体中保留，API >=30的变体里会直接删掉这个节点。

注意：这个规则是构建时生效的，做不到单APK在运行时动态增删节点。如果你是单APK覆盖所有API版本发版，不要用这个方案，优先选方案1。

方案3：代码层加版本判断兜底 #

如果前面两个方案因为接入的SDK逻辑太特殊不生效，直接在读取meta-data、执行对应逻辑的地方加SDK版本判断就行，最稳妥：

// 读取配置、执行对应逻辑的位置加判断
if (Build.VERSION.SDK_INT < Build.VERSION_CODES.R) { // 仅API <30时走旧逻辑
    val metaData = packageManager.getApplicationInfo(packageName, PackageManager.GET_META_DATA).metaData
    val disableBatchScan = metaData.getBoolean("disable_batch_scanning", false)
    // 执行批量扫描禁用的相关逻辑
}

这个方案完全不受Manifest、资源匹配规则的限制，逻辑自己可控，不会出莫名其妙的适配问题。

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