最近在升级 Kotlin 和 AGP (Android Gradle Plugin) 等工具链后，你可能遇到了一个奇怪的现象：应用图标突然变回了安卓默认图标，或者显示了一个错误的自定义图标。经过排查，你发现问题出在一个组件库中的 drawable-anydpi-v24 目录。
为什么旧版本没问题，新版本却“犯病”了？这背后牵扯到 Android 资源解析机制的演进，尤其是 自适应图标（Adaptive Icons） 带来的优先级变化。
问题核心：资源优先级与 anydpi 的崛起
这个问题的根源在于 Android 资源选择机制在新的 AGP 版本中对特定限定符（Qualifier）赋予了更高的权重。
1. anydpi 限定符的威力
anydpi (Any Density Independent Pixel) 限定符首次在 API Level 21 (Android 5.0) 中启用，主要用于 Vector Drawables (矢量图) 。
它的核心作用是：赋予资源最高的密度优先级。
- 设计意图： 矢量图与密度无关，可以无损缩放。
anydpi告诉系统：“这是一个密度无关的资源，请优先使用它，并跳过那些特定密度的位图（如hdpi,xxhdpi目录下的 PNG）。” - 高优先级： 在资源选择的众多限定符中，
anydpi目录下的资源在满足版本条件时，会强势覆盖所有其他特定密度的位图资源。
2. drawable-anydpi-v24 的作用
你发现问题的目录是 drawable-anydpi-v24，它的含义是：
“在 API Level 24 及以上的设备上，使用这个密度无关（Any DPI）的资源。”
当你的 AGP 升级并针对更高的 targetSdkVersion 编译时，构建工具和系统运行时的资源解析逻辑变得更加严格，并开始更严格地遵循 anydpi 的高优先级规则。
为什么旧版没问题，新版出问题？
旧版本 AGP 和 Android 系统可能采取了较宽松的资源合并和选择策略：
- 旧 AGP 策略： 你的自定义启动器图标可能被放在了
mipmap-hdpi/等特定密度目录中，或者被定义在AndroidManifest.xml中。旧版本可能因为各种原因（比如 Manifest 引用、mipmap目录的特殊性）优先选择了你期望的图标，从而忽略了组件库中drawable-anydpi-v24下的潜在冲突。 - 新 AGP 策略（API ≥24）： 升级后，AGP 强制提高了
anydpi的优先级。如果你的组件库（或其他地方）的drawable-anydpi-v24中有一个与启动器图标引用同名的 Drawable 文件（例如ic_launcher_foreground.xml或ic_launcher_background.xml），即使它是一个默认、错误或不完整的占位符，系统也会优先选择它。
一旦这个错误的资源被系统选中作为图标的某个组成部分（例如前景层），它就会破坏你完整的图标定义，导致最终显示错误的图标，或者系统回退到默认的安卓图标。
解决方案和最佳实践
解决这个问题的关键是消除优先级冲突并遵循最新的 Android 图标规范。
1. 检查和清理组件库冲突
- 识别冲突文件： 检查你的组件库或 App 模块中
res/drawable-anydpi-v24/目录下的文件。 - 移除/重命名： 如果发现与你应用主图标（如
ic_launcher_foreground.xml、ic_launcher_background.xml等）同名的文件，如果确认是无用的旧文件或默认占位符，请将其移除或重命名。
2. 遵循自适应图标标准
确保你的 启动器图标 严格遵循自适应图标的官方标准：
| 资源用途 | 推荐目录 | 关键版本 | 目的 |
|---|---|---|---|
图标 XML 定义 (ic_launcher.xml) | res/mipmap-anydpi-v26/ | API 26+ | 确保在支持自适应图标的设备上，以最高优先级使用你的图标定义。 |
图标前景/背景 (ic_launcher_foreground.xml 等) | res/drawable/ | - | 存放 Vector Drawable，因为它们本身是密度无关的，放置在基础 drawable/ 即可。 |
3. 使用 Image Asset Studio 修复
如果手动修复困难，最可靠的方法是使用 Android Studio 内置工具：
- 右键点击
res目录 -> New -> Image Asset。 - 选择 Launcher Icons (Adaptive and Legacy) 。
- 导入您的前景和背景资源，让工具自动为您在
mipmap-anydpi-v26和其他目录中生成正确的文件，从而覆盖所有潜在的冲突资源。
通过理解 anydpi 限定符在资源解析中的高优先级，你就能更好地管理应用图标资源，避免因工具链升级带来的意外“换脸”问题。
