MAUI项目iOS端启动页始终显示白屏问题求助
MAUI iOS端启动页始终白屏的解决方案
针对你遇到的MAUI iOS启动页白屏问题,结合你的现有配置,可按以下步骤排查解决:
1. 修复图片资源引用问题
你的LaunchScreen.storyboard中引用了splash_icon图片,但该资源未在MAUI项目中正确部署:
- 将包含多分辨率变体(如@sx、@2x、@3x)的
splash_icon.png放入项目的Platforms/iOS/Resources/Images目录; - 在项目
.csproj中添加图片资源配置:
<ItemGroup> <ImageAsset Include="Platforms\iOS\Resources\Images\splash_icon.png" /> </ItemGroup>
也可将图片添加到Platforms/iOS/Assets.xcassets资源包中,确保storyboard能正确加载图片。
2. 确认Storyboard文件属性
右键LaunchScreen.storyboard文件,检查属性:
- 生成操作必须设置为
InterfaceDefinition; - 复制到输出目录设置为
如果较新则复制。
(即使你已在.csproj手动配置,也要确保文件属性与配置一致)
3. 清理项目与模拟器缓存
MAUI iOS项目的缓存易导致资源加载异常,执行以下操作:
- 删除项目根目录下的
bin和obj文件夹; - 打开iOS模拟器,通过
菜单 > 硬件 > 擦除所有内容和设置清除模拟器缓存; - 重启开发工具,重新生成并部署项目。
4. 修复Storyboard的无效约束
用Xcode打开LaunchScreen.storyboard,会发现代码中存在针对未定义控件nP3-5F-Xa6的约束,这会直接导致storyboard加载失败。需删除这两条无效约束,或重新添加对应的控件并配置约束。
5. 检查Info.plist的冲突配置
打开Platforms/iOS/Info.plist,确认没有残留的UILaunchImages旧版启动图配置,若存在需删除,避免与UILaunchStoryboardName配置冲突。
6. 验证iOS目标版本兼容性
你的storyboard要求最低iOS版本为9.0,需确保MAUI项目的iOS目标版本不低于此:
打开项目.csproj,检查TargetFrameworks中的iOS版本,示例:
<TargetFrameworks>net8.0-ios17.0;net8.0-android</TargetFrameworks>
确保版本号≥9.0。
内容的提问来源于stack exchange,提问作者MaxShap
相关产品推荐
相关产品推荐

