You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.06.19 14:07:34