为何Android资源覆盖在minSdk24+失效？求技术解答

问题描述 #

当Library B的minSdk设为23时，能正常覆盖依赖的EXTERNAL_LIBRARY中的资源；但设为24或更高版本时，资源覆盖失效。

项目结构 #

A (Application)
└── B (Library)

Gradle配置 #

// build.gradle for A 
// ...
dependencies {
    implementation project(':B')
}

//////////////////////

// build.gradle for B
android {
    defaultConfig {
        minSdk 23 // 设为23时资源覆盖正常，24及以上失效
    }
}

dependencies {
    api EXTERNAL_LIBRARY
}

EXTERNAL_LIBRARY包含library_icon资源（红色圆形），在B中将该资源替换为蓝色圆形，期望显示蓝色圆形，但minSdk≥24时不生效。

原因分析 #

这是因为Android Gradle Plugin（AGP）针对minSdk≥24的Library启用了资源私有化特性：

• 当Library的minSdkVersion≥24时，AGP会使用AAPT2的资源命名空间隔离机制，自动给Library中定义的资源添加私有前缀（基于Library的包名/命名空间）。
• 此时B中定义的library_icon资源会被重命名为类似com_example_b_library_icon的形式，而EXTERNAL_LIBRARY中的library_icon是无前缀的公共资源，两者名称不再一致，自然无法实现覆盖。
• 当minSdk<24时，AGP不会启用该特性，资源保持原始名称，因此B的资源能按照依赖优先级覆盖EXTERNAL_LIBRARY的资源。

解决方法 #

方法1：禁用Library B的资源私有化 #

在B的build.gradle中添加资源配置，关闭自动添加私有前缀的功能：

android {
    // 若使用AGP 7.0+，需先指定namespace
    namespace "com.your.b.namespace"
    
    resources {
        // 禁用资源私有前缀，允许覆盖依赖库的同名资源
        disableResourcePrefix = true
    }
}

方法2：声明要覆盖的资源为公共资源 #

在Library B的res/values/public.xml文件中，将需要覆盖的资源声明为公共资源（若没有该文件则新建）：

<resources>
    <public name="library_icon" type="drawable" />
</resources>

该配置会告诉AGP不要给这个资源添加私有前缀，保持原始名称，从而可以正常覆盖EXTERNAL_LIBRARY中的同名资源。

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