.NET MAUI Blazor iOS端无法更换启动屏问题求助

针对替换SVG后仍显示默认.NET启动屏和图标的问题，按以下步骤排查修复：

1. 彻底清理项目缓存 #

• 删除项目根目录下的bin和obj文件夹
• 在Visual Studio中点击「生成」→「清理解决方案」
• 打开配对的Mac设备，删除Xcode派生数据：打开Xcode → 「Xcode」菜单 → 「设置」→ 「Locations」→ 点击「Derived Data」旁的箭头，删除对应项目的文件夹

2. 验证SVG文件兼容性 #

MAUI对启动屏和图标SVG有严格要求，确保你的自定义文件满足：

• 无外部资源引用（如外部字体、图片）
• 所有元素合并为单个路径（避免复杂分组或嵌套）
• 尺寸符合规范：启动屏SVG建议用1242×2688像素（适配iPhone全系列），图标SVG建议用1024×1024像素
• 不包含动画或交互元素

3. 检查项目配置文件（.csproj） #

打开项目.csproj文件，确认以下配置项正确：

• 启动屏配置：

<MauiSplashScreen Include="Resources\Splash\splash.svg" Color="#FFFFFF" />

• 图标配置：

<MauiIcon Include="Resources\AppIcon\appicon.svg" ForegroundFile="Resources\AppIcon\appiconfg.svg" Color="#512BD4" />

确保路径与你的文件位置一致，无多余配置覆盖。

4. 重置iOS部署环境 #

• 从iPhone上彻底卸载当前应用
• 在Visual Studio中重新设置iOS签名：进入项目属性 → iOS → 捆绑签名，先切换为「手动配置」再切回「自动配置」，等待签名配置完成
• 重新生成解决方案并部署到iPhone

5. 验证Xcode自动生成的资源 #

MAUI会自动将SVG转换为iOS原生资源，你可以在Mac的项目派生数据中找到生成的LaunchScreen.storyboard和图标文件，确认是否包含自定义内容：

• 派生数据路径一般为~/Library/Developer/Xcode/DerivedData/[项目名]-[随机字符串]/Build/Products/Debug-iphoneos/[应用名].app
• 查看LaunchScreen.storyboard中的图片引用，确认是否为你的自定义启动屏

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