.NET MAUI修改启动画面后仅显示紫色屏幕,求排查建议
.NET MAUI启动画面修改后仅显示紫色屏幕的排查建议
检查项目文件(.csproj)中的MauiSplashScreen配置
- 右键
splash.svg文件打开属性面板,确认生成操作设置为MauiSplashScreen;也可以直接查看.csproj中的条目,确保没有错误配置:<MauiSplashScreen Include="Resources\Splash\splash.svg" /> - 排查是否存在额外的
Color属性强制设置背景色,比如如果配置了Color="#8A2BE2"这类紫色值,会覆盖SVG自身的背景设置。
- 右键
验证SVG文件的.NET MAUI兼容性
- .NET MAUI对SVG支持有限,避免使用复杂滤镜、CSS渐变、外部资源引用,仅保留基础路径、文本等元素。
- 确保SVG使用相对尺寸(比如设置
viewBox="0 0 100 100"),不要用绝对像素值,否则可能导致渲染异常。 - 先简化SVG内容(比如只留一行文本)测试,排除复杂元素引发的渲染问题。
清理缓存并重建项目
- 执行Visual Studio菜单的「生成→清理解决方案」
- 手动删除项目根目录下的
bin和obj文件夹,清除旧资源缓存 - 重新生成并部署应用,确保新SVG被正确编译
检查平台特定配置
- Android:查看
Resources\drawable\splash.xml是否为自动生成,避免手动修改的配置覆盖SVG资源 - iOS:检查
Resources\Images.xcassets\Splash.imageset下的自动生成图片,若设备/模拟器缓存旧资源,需先卸载应用再重新安装
- Android:查看
测试默认SVG的可用性
- 暂时恢复项目自带的默认
splash.svg,如果能正常显示,说明问题出在你修改的SVG文件;如果默认文件也显示紫色,可能是Visual Studio 17.3 Preview 4的版本bug,可尝试更新预览版或回退到稳定版测试。
- 暂时恢复项目自带的默认
内容的提问来源于stack exchange,提问作者Wallace B. McClure
相关产品推荐
相关产品推荐

