张牛顿1. 问题现象与排查思路
最近在Flutter项目开发中遇到一个奇怪现象：打包后的APK安装到手机后，应用确实存在于应用列表中，但桌面上却找不到应用图标。这种情况在Android设备上尤为常见，特别是当我们使用flutter create命令初始化项目后，直接运行flutter build apk生成的安装包。
经过多次测试和排查，我发现问题通常出在Android平台的图标资源配置上。Flutter默认会生成一套适应不同DPI的mipmap资源，其中就包含一个特殊的anydpi-v26目录。这个目录是Android 8.0（API 26）引入的适配机制，用于支持自适应图标(Adaptive Icons)。
注意：如果你的项目不需要支持Android 8.0+的自适应图标特性，这个v26目录下的配置文件反而可能导致图标显示异常。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 图标资源配置机制解析
2.1 Android图标体系演变
Android的图标系统经历了多次迭代：
- 传统位图图标（API 1-25）：使用png格式的静态图片，需要为不同DPI提供多套资源
- 自适应图标（API 26+）：引入矢量+位图的组合方式，支持动态形状和视觉效果
- 单色图标（API 30+）：进一步简化为单色模板，由系统统一着色
Flutter项目默认会同时兼容这三种模式，这可能导致在某些设备上出现兼容性问题。
2.2 Flutter的图标生成逻辑
当执行flutter create时，Flutter CLI会：
- 在
android/app/src/main/res/下创建标准mipmap目录 - 生成默认的启动图标（ic_launcher.png）
- 为API 26+创建
mipmap-anydpi-v26目录 - 在该目录下生成
ic_launcher.xml或launcher_icon.xml
问题就出在这个XML文件上——它定义了自适应图标的组成方式，但如果你的实际图标资源不符合要求，就会导致图标无法正常显示。
3. 解决方案与详细步骤
3.1 方法一：删除v26配置文件（推荐）
这是最简单直接的解决方案：
bash复制# 进入项目android目录
cd android/a