MAUI类库中SVG图片显示异常问题求助

问题概述 #

在.NET 7 MAUI类库（非调用它的应用程序）中添加Dropbox SVG图标时，出现跨平台显示异常，参考默认dotnet_bot.svg示例仍无法解决问题。

现象总结 #

• 命名为dropboxicon.svg时：Windows端正常显示，Android端仅显示空白
• dotnet_bot.svg：全平台正常显示，但重命名为dotnetbot.svg后两端均失效
• 将dropboxicon.svg重命名为dotnet_bot.svg，仍无法正常显示

操作步骤 #

• 创建.NET 7 MAUI类库，关联测试MAUI应用并设为主页，将默认dotnet_bot.svg复制到类库Resources/Images文件夹，Windows和Android端均正常显示
• 修改csproj中图片引用为Images/*，仍可正常工作
• 复制dropboxicon.svg到Images文件夹并设为页面内容，Windows正常，Android显示空白
• 重命名dotnet_bot.svg为dotnetbot.svg，两端均失效
• 将dotnet_bot.svg重命名为dotnet_bot_old.svg，dropboxicon.svg改为dotnet_bot.svg，仍显示Bot图片，清理重建无效

后续情况 #

• 后续操作后Windows端也失效，重建测试仓库后Windows恢复正常，但Android端仍异常
• 确认对应MAUI官方已知问题，当前环境：VS 17.7.3、.NET 7类库/应用、Xamarin Android 13.2.1.2、MAUI 7.0.92

可行Workaround #

1. 转换SVG为平台兼容位图格式 #

将SVG转为PNG/JPG格式，遵循MAUI图片命名规范（如dropboxicon.png、dropboxicon.android.png）放置到Resources/Images目录，在csproj中确保正确配置MauiImage项：

<MauiImage Include="Resources\Images\dropboxicon.png" />
<MauiImage Include="Resources\Images\dropboxicon.android.png" Condition="$(TargetFramework.Contains('-android'))" />

2. 手动指定SVG的构建操作 #

在类库的csproj中，为目标SVG明确添加构建项，避免使用通配符导致Android端解析异常：

<MauiImage Include="Resources\Images\dropboxicon.svg" />

3. 彻底清理MAUI缓存 #

• 删除Windows端VS缓存：%USERPROFILE%\AppData\Local\Microsoft\VisualStudio\<你的VS版本号>\ComponentModelCache
• 删除项目目录下的obj、bin文件夹
• 清除Android模拟器/真机上的应用缓存，重新部署

4. 升级MAUI版本 #

升级到.NET 7的最新补丁版本或直接迁移到.NET 8，官方在后续版本中修复了部分SVG资源在类库中的加载问题

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