Flutter应用iOS图标配置问题：运行时仍显示默认图标

针对主屏幕图标正常但运行时仍显示默认图标的情况，按以下步骤排查修复：

1. 区分主屏幕图标与启动屏图标 #

flutter_launcher_icons仅负责生成主屏幕图标，不会自动替换启动屏（Splash Screen）上的图标。如果运行时显示的是启动屏里的默认图标，需要单独处理：

• 打开iOS项目的Runner/Assets.xcassets，找到LaunchImage.imageset，替换其中所有尺寸的图片为自定义图标；
• 也可使用flutter_native_splash包统一配置启动屏资源。

2. 清理缓存并重新构建 #

iOS项目的缓存可能导致旧图标残留，执行以下操作：

• 关闭Xcode；
• 删除iOS目录下的build文件夹；
• 执行Flutter清理命令：

  flutter clean
  

• 重新生成图标并构建项目：

  dart run flutter_launcher_icons
  flutter build ios
  

3. 手动验证iOS图标资源 #

确认Xcode中的App Icon已完全替换：

• 打开iOS项目的Runner.xcworkspace；
• 导航到Runner/Assets.xcassets/AppIcon.appiconset；
• 检查所有尺寸的图标是否都已替换为自定义图标，没有残留的默认Flutter图标。

4. 检查pubspec.yaml的配置正确性 #

确保flutter_launcher_icons的配置明确覆盖iOS平台，且图标路径正确：
示例有效配置：

flutter_launcher_icons:
  android: "launcher_icon"
  ios: true
  image_path: "assets/icons/app_icon.png"
  remove_alpha_ios: true # 可选，避免iOS图标因透明通道显示异常

若配置中ios字段为false或图标路径错误，会导致iOS图标未完全生成。

5. 重启设备并重装应用 #

设备的图标缓存可能无法即时刷新：

• 删除设备上的目标应用；
• 重启iOS设备；
• 重新安装应用。

内容的提问来源于stack exchange，提问作者polina-c