iOS端无法替换MAUI应用图标与启动屏问题求助

问题现象 #

iOS端始终显示默认紫色背景白色.NET标识的图标和启动屏，Android、Windows端自定义资源正常生效；已清理.bin/.obj目录、更换设备/项目、切换.NET 7/8版本，问题仍存在；csproj已配置自定义MauiIcon和MauiSplashScreen，Info.plist也尝试调整UILaunchStoryboardName配置。

排查与解决步骤 #

1. 完善csproj资源配置参数 #

编辑项目的.csproj文件，确保MauiIcon和MauiSplashScreen配置包含强制处理参数，避免资源被忽略：

<ItemGroup>
  <!-- 图标配置：指定Resize确保生成多尺寸图标，Color可选（若图标有透明区域可填充背景） -->
  <MauiIcon Include="Resources\AppIcon\appicon.png" Resize="True" Color="#000000" />
  <!-- 启动屏配置：Resize确保适配各设备尺寸 -->
  <MauiSplashScreen Include="Resources\Splash\splashscreen.png" Resize="True" />
</ItemGroup>

2. 彻底清理本地缓存与构建产物 #

执行以下命令完全重置构建环境，避免缓存残留：

# 清理MAUI项目构建产物
dotnet clean
# 清除NuGet本地缓存
dotnet nuget locals all --clear
# 清除Xamarin/iOS构建缓存（Mac环境）
rm -rf ~/Library/Caches/Xamarin/mtbs/
# Windows环境需手动删除：C:\Users\<用户名>\AppData\Local\Xamarin\Cache

完成后重启开发工具（Visual Studio/VS for Mac）及iOS模拟器/连接的Mac设备。

3. 检查iOS平台专属配置文件 #

• 打开iOS平台目录下的Info.plist（而非共享的Info.plist），确认：
  • 不存在CFBundleIcons节点的旧默认图标引用，若有则删除
  • UILaunchStoryboardName值为MauiSplash时，打开Platforms/iOS/MauiSplash.storyboard，手动将ImageView的图片源替换为自定义splashscreen.png
• 若使用图标集（.appiconset），直接将完整图标集文件夹放入Resources/AppIcon目录，修改csproj引用为：

  <MauiIcon Include="Resources\AppIcon\AppIcon.appiconset" />
  

4. 验证图片格式与合规性 #

• 图标：必须为1024x1024尺寸的PNG文件，无损坏；若使用图标集，确保包含iOS要求的所有尺寸（如16x16、20x20、60x60等）
• 启动屏：建议使用2732x2732尺寸的PNG，避免透明区域（iOS启动屏不支持透明背景）

5. 直接通过Xcode修改资源 #

打开项目iOS目录下的<项目名>.xcodeproj，在Xcode中操作：

1. 导航到Assets.xcassets
2. 替换AppIcon和LaunchImage中的所有默认图片
3. 直接在Xcode中构建并运行项目，确认自定义资源生效后，再回到MAUI项目进行构建

内容的提问来源于stack exchange，提问作者Jeremy A.