.NET MAUI部署至iOS时启动页未更新的问题排查求助

问题场景 #

给.NET MAUI项目更换自定义启动页时遇到异常：

• 已将启动页替换为自制PNG文件，路径为Resources\Splash\uglsplash.png
• 更新项目.csproj配置如下：

  <MauiSplashScreen Include="Resources\Splash\uglsplash.png"  BaseSize="512,515" Color="#FFFFFF"/>
  

安卓模拟器显示自定义启动页正常，但部署到iPad时仍显示.NET默认启动页。

问题原因 #

iOS（包含iPad）的启动资源处理逻辑与安卓存在差异：

• PNG作为位图文件，iOS资源编译系统在处理非默认命名、非SVG格式的启动图时，容易出现适配或缓存问题，导致无法覆盖默认启动资源
• .NET MAUI原生启动页模板采用SVG格式，iOS对矢量图的资源识别和适配更稳定，且默认命名的资源更容易被系统正确加载

解决步骤 #

1. 将自制的PNG启动图转换为SVG格式
2. 使用默认模板的命名规则（例如splash.svg），将文件放在Resources\Splash目录下
3. 更新.csproj中的配置路径：

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

重新编译并部署到iPad后，自定义启动页即可正常显示。

内容的提问来源于stack exchange，提问作者Clinton Wheeler