Android多构建类型下资源文件优先级规则及异常问题咨询

核心现象原因 #

你遇到的差异是因为启动图标资源存在Gradle插件的特殊处理逻辑，而普通字符串资源遵循标准的变体资源优先级规则：

• 普通资源（如字符串）：release/res/values 目录的资源优先级高于 main/res/values，构建时会直接覆盖同名资源
• 启动图标（ic_launcher.png 这类）：Android Gradle 插件默认在 release 构建时优先使用 main 目录下的图标，除非你显式配置变体专属的完整图标结构

通用资源选择决策逻辑 #

Android 资源的优先级遵循以下层级（从高到低）：

• 构建变体专属资源目录（如 release/res、debug/res）
• 构建类型资源目录（如 build-types/release/res）
• 产品风味资源目录（如 flavors/free/res）
• main 模块资源目录（main/res）
• 依赖库资源目录

同名资源会被优先级更高的目录中的资源覆盖，但系统或 Gradle 插件针对特定资源类型有例外处理，启动图标就是典型案例。

启动图标特殊处理的细节 #

Gradle 插件对启动图标做特殊限制是为了避免变体间图标配置混乱，要让 release 目录的图标生效，需要满足以下任一条件：

• 在 release/res 目录下创建完整的自适应图标结构：不仅要在对应 mipmap 目录放 png 文件，还要在 mipmap-anydpi-v26 目录下创建 ic_launcher.xml 定义自适应图标配置
• 在 app 模块的 build.gradle 中显式指定变体专属图标：

  android {
      buildTypes {
          release {
              manifestPlaceholders = [appIcon: "@mipmap/ic_launcher_release"]
          }
      }
  }
  

  同时在 AndroidManifest.xml 中将 icon 属性改为 ${appIcon}

官方资料获取途径 #

• 直接在 Android Studio 中通过「Help > Android Developer Documentation」入口，搜索「Resource merging」「Build variants resources」「Adaptive icons」关键词，查看官方的资源合并规则和变体资源处理说明
• 查阅 Android Gradle 插件官方文档，重点关注构建变体资源的特殊处理逻辑
• 查看 Android 开发者文档中「应用图标设计与适配」章节，了解启动图标的配置优先级规则

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