Android Studio 构建变体中的资源选择顺序详解

在 Android 开发中，我们经常会遇到同一个资源文件在不同目录下都有定义的情况，比如应用图标（icon）既存在于 main 目录下，又存在于 debug 目录或者某个 productFlavor 目录下。那在打包 APK 时，Android Studio 到底会选择哪一个版本的资源呢？本文将详细解析 资源合并的优先级。

一、背景知识：构建变体与资源合并

在 Android 工程中，构建变体（Build Variant） 是由 构建类型（Build Type，如 debug/release） 和 产品风味（Product Flavors） 共同决定的。

Gradle 在打包时会执行 资源合并（Resource Merging） ，按照一定的优先级顺序来决定最终进入 APK 的资源文件。

简单原则：目录越具体，优先级越高；目录越通用，优先级越低。

二、资源优先级顺序

假设我们有如下构建配置：

android {flavorDimensions "environment", "channel"productFlavors {dev {dimension "environment"}google {dimension "channel"}}
}

如果我们选择的构建变体是 devGoogleDebug，Gradle 会按以下顺序查找并合并资源：

1. 构建变体专属目录：src/devGoogleDebug/res/
2. 组合 Flavor 目录：src/devGoogle/res/
3. 单一 Flavor 目录：src/dev/res/ 和 src/google/res/
4. 构建类型目录：src/debug/res/
5. main 目录：src/main/res/

📊 图示化结构

优先级（高 → 低）src/devGoogleDebug/res/   ← 最高优先级
src/devGoogle/res/
src/dev/res/
src/google/res/
src/debug/res/
src/main/res/             ← 最低优先级（兜底）

三、结合实际场景

假设你有一张图标 icon.png，分别存在于以下目录：

• src/main/res/mipmap-xxxhdpi/icon.png
• src/debug/res/mipmap-xxxhdpi/icon.png
• src/dev/res/mipmap-xxxhdpi/icon.png

那么：

• 在构建 devGoogleDebug 变体时，最终 APK 会选择 src/dev/res/ 下的图标，因为它比 debug 和 main 更具体。
• 如果 src/devGoogle/res/ 或 src/devGoogleDebug/res/ 下也有同名图标，则优先级更高，它们会覆盖掉 src/dev/res/ 中的版本。

四、常见细节与陷阱

1. 同名资源冲突：同一个目录下不允许存在同名但不同类型的资源，否则会编译报错。
2. 多维度组合目录：当有多个 flavorDimension 时，Gradle 会自动生成组合目录（如 src/devGoogle/）。
3. 构建类型覆盖：src/debug/res/ 中的资源可以覆盖 main，但仍然可能被 flavor 资源覆盖。
4. IDE 显示差异：Android Studio 的资源预览可能和最终打包有差异，但 APK 的结果一定遵循上述优先级。

五、总结

在 Android Studio 中，资源合并遵循 “最具体优先” 的原则：

• devGoogleDebug > devGoogle > dev > google > debug > main

一句话总结：

如果同一个资源在多个目录下存在，最终 APK 会选择当前构建变体最具体目录下的版本。

✅ 通过掌握资源合并的顺序，我们就能合理地管理多环境、多渠道、多构建类型下的资源，避免意外的覆盖或冲突。