.NET MAUI项目Android与iOS端App图标显示异常求助

iOS端默认图标未替换的修复步骤 #

1. 修正csproj配置
   当前MauiIcon配置缺少iOS图标生成的必要参数，需补充前景文件配置（可复用同一SVG），确保路径准确。修改后的配置如下：

   <!-- 注释默认配置 -->
   <!-- <MauiIcon Include="Resources\AppIcon\appicon.svg" ForegroundFile="Resources\AppIcon\appiconfg.svg" Color="#512BD4" /> -->
   <MauiIcon Include="Resources\AppIcon\logo_intro_icon.svg" 
             ForegroundFile="Resources\AppIcon\logo_intro_icon.svg"
             Color="#FFFFFF" /> <!-- 可选：根据图标调整前景色 -->
   

2. 清理缓存并重建
   • 删除项目根目录下的bin和obj文件夹
   • 执行清理解决方案 -> 重建解决方案
   • 卸载模拟器中的旧应用后重新部署

Android端图标过大、强制圆形的修复步骤 #

Android自适应图标要求区分前景与背景层，当前仅指定主图标文件会导致系统套用默认圆形背景，且前景图未适配显示过大。

1. 完善MauiIcon配置
   补充前景、背景配置（无自定义背景SVG时可直接指定纯色背景）：

   <MauiIcon Include="Resources\AppIcon\logo_intro_icon.svg" 
             ForegroundFile="Resources\AppIcon\logo_intro_icon.svg"
             BackgroundColor="#FFFFFF"
             Color="#FFFFFF" />
   

   若有自定义背景SVG，替换为BackgroundFile="Resources\AppIcon\background.svg"即可。
2. 修正AndroidManifest.xml配置
   MAUI会自动生成appicon系列mipmap资源，无需手动指定自定义文件名，改回默认配置：

   <application android:allowBackup="true" android:icon="@mipmap/appicon" android:supportsRtl="true" android:label="InnerMonk"></application>
   

3. 清理Android资源缓存
   • 删除Platforms\Android\Resources\mipmap-*文件夹下的旧图标文件
   • 清理并重建项目后重新部署

通用注意事项 #

• SVG图标建议使用1024x1024基础尺寸（MAUI官方推荐，自动适配各平台缩放），420x420易导致缩放失真
• 确保SVG文件无多余空白边距，避免图标显示时出现视觉偏移或留白
• 若使用Visual Studio for Windows，右键Android项目选择Properties -> Android Manifest，确认图标选择@mipmap/appicon

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