iOS最近任务界面显示默认Flutter图标 已配置全尺寸AppIcon如何修复

1. 优先清理缓存验证 #

• 完全卸载设备上的现有App，重启iOS设备后重新编译安装App，避免系统缓存旧图标资源
• 清理Xcode缓存：打开Xcode -> 点击顶部菜单栏Xcode -> Settings -> Locations -> 点击DerivedData右侧的箭头打开目录，删除整个DerivedData文件夹后重新编译项目

2. 检查Info.plist图标配置 #

• 打开iOS项目的Info.plist文件，确认CFBundleIcons（图标文件）配置正确：
  • 展开CFBundlePrimaryIcon（主图标）节点，确认CFBundleIconName的值为AppIcon（和Assets.xcassets里的图标集名称完全一致）
  • 检查是否存在残留的CFBundleIconFiles旧配置项，如果有直接删除，避免和Assets配置冲突
  • 确认没有配置错误的备用图标CFBundleAlternateIcons相关条目

3. 检查AppIcon资源集配置 #

• 打开iOS项目下的Assets.xcassets，确认AppIcon集里所有尺寸的图标都已正确填充，无空缺、无尺寸错配
• 确认项目中没有其他同名的AppIcon资源集（比如第三方依赖库带的同名资源），避免资源冲突
• 确认1024*1024尺寸的App Store图标已正确上传到AppIcon集，部分iOS版本会调用该尺寸缩放用于最近任务界面显示
• 检查Runner目录下是否存在Flutter默认生成的旧图标文件（如Icon-App.png等），如果有直接删除，避免资源优先级高于Assets配置

4. Flutter侧配置校验 #

• 如果使用flutter_launcher_icons插件生成图标，确认pubspec.yaml里的iOS相关配置完整：

  flutter_icons:
    ios: true
    image_path: "你的图标路径"
    remove_alpha_ios: true
  

• 重新执行图标生成命令：flutter pub run flutter_launcher_icons，再重新编译运行项目

5. 代码逻辑校验 #

• 检查项目代码中是否调用过setAlternateIconNameiOS系统接口修改过应用图标，确认没有残留的图标替换逻辑未还原

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