Android自适应图标显示异常：预览正常实际为方形内圆形

排查修复步骤： #

1. 补全低版本系统的图标资源 #

自适应图标是Android 8.0（API 26）才支持的，低于这个版本的系统不认anydpi-v26里的xml配置，会自动生成兼容图标，容易出现方形套圆形的问题。

• 解决：在每个普通mipmap目录（mipmap-mdpi、mipmap-hdpi、mipmap-xhdpi等）里，放一张完整的方形图标（把前景和背景合并成一张图），命名为app_icon_v4.png。

2. 完善Manifest的图标配置 #

只设置android:icon的话，部分支持圆形图标的设备会强制裁剪自适应图标，导致显示异常。

• 解决：在<application>标签里加上android:roundIcon配置，和icon使用同一个资源：

  android:icon="@mipmap/app_icon_v4"
  android:roundIcon="@mipmap/app_icon_v4"
  

3. 检查前景图的安全区域 #

自适应图标的前景内容必须放在中心72x72dp的安全区内（对应48x48dp的图标容器），超出的部分会被系统裁剪，可能导致显示异常。

• 解决：重新通过Image Asset向导生成前景图，确保核心内容在安全区内，不要过度扩展到边缘。

4. 清理缓存并重新构建项目 #

Android Studio的缓存或旧构建产物可能导致图标显示异常，尤其是修改图标资源后。

• 操作：
  • 点击菜单栏Build -> Clean Project
  • 再点击Build -> Rebuild Project
  • 卸载设备上的旧应用，重新安装

5. 排除第三方启动器干扰 #

部分第三方启动器会强制给所有图标添加圆形/方形蒙版，导致自适应图标显示不符合预期。

• 验证：切换到系统原生启动器（如Pixel Launcher）测试图标显示，确认是否是第三方启动器的问题。

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