.NET MAUI应用启动图标不显示问题求助

一、通用配置检查 #

• 确认SVG文件路径：将配置中的路径分隔符改为正斜杠/，即Resources/Splash/mysplash.svg，避免跨平台路径解析差异；同时检查文件是否确实存在于对应目录。
• 验证SVG兼容性：.NET MAUI不支持SVG的滤镜、渐变动画、外部引用等复杂特性，建议用简化版SVG（仅保留基础图形和固定填充色），可通过SVG优化工具精简后再导入。
• 调整BaseSize：确保128,128与SVG本身的画布尺寸比例一致，比例偏差过大可能导致缩放异常。

二、iOS平台修复 #

iOS仅显示黑背景，说明SVG未被正确渲染，需补充以下操作：

• 检查Platforms/iOS/Info.plist：右键项目→属性→iOS应用程序→启动图像，确认已绑定到MauiSplashScreen生成的资源，避免手动修改Info.plist导致关联丢失。
• 清理模拟器缓存：删除模拟器中的应用，重启模拟器后重新部署，iOS模拟器常缓存旧启动屏资源导致新配置不生效。
• 替换SVG动态颜色：若SVG使用currentColor或依赖系统主题的颜色，启动阶段无法解析，需改为固定颜色值。

三、Android平台修复 #

Android完全无启动屏，核心是缺失启动主题配置：

• 编辑Platforms/Android/Resources/values/styles.xml，确保启动主题引用MAUI启动屏资源：

  <style name="Maui.SplashTheme" parent="Maui.BaseTheme">
      <item name="android:windowBackground">@drawable/maui_splash</item>
  </style>
  

• 确认Platforms/Android/AndroidManifest.xml中应用主题设置为Maui.SplashTheme：

  <application android:allowBackup="true" android:icon="@mipmap/appicon" android:roundIcon="@mipmap/appicon_round" android:supportsRtl="true" android:theme="@style/Maui.SplashTheme">
  

• 清理构建缓存：删除项目的bin和obj目录，重新构建项目，避免Android构建系统缓存旧资源。

四、额外验证 #

• 确认NuGet包版本：右键项目→管理NuGet包，保证Microsoft.Maui.Controls与Microsoft.Maui.Controls.Compatibility版本一致且为最新稳定版，版本不匹配会导致资源处理异常。
• 替换为PNG测试：如果PNG格式能正常显示，说明问题出在SVG本身的兼容性，而非配置。

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