MAUI中Android端矩形SVG启动屏显示失真问题求助

核心问题 #

Android默认启动屏机制会强制将图片拉伸至全屏，而SVG矢量图在Android的layer-list中如果未正确配置，会因缩放或过滤导致失真——这就是iOS显示正常但Android出问题的根源，单独使用Logo时的失真也源于同一逻辑。

具体修复步骤 #

1. 自定义Android启动屏布局（关键） #

在Platforms/Android/Resources/drawable目录下新建splash_screen.xml，通过layer-list确保SVG居中且不被拉伸：

<?xml version="1.0" encoding="utf-8"?>
<layer-list xmlns:android="http://schemas.android.com/apk/res/android">
  <!-- 匹配SVG的背景色，避免出现白边 -->
  <item android:drawable="@color/splash_bg"/>
  <!-- 居中显示Logo，禁用过滤防止模糊失真 -->
  <item>
    <bitmap
      android:src="@drawable/your_splash_logo"
      android:gravity="center"
      android:filter="false"/>
  </item>
</layer-list>

在Platforms/Android/Resources/values/colors.xml中添加对应背景色：

<color name="splash_bg">#FFFFFF</color> <!-- 替换为你的SVG实际背景色 -->

2. 生成Android适配密度的矢量资源 #

直接使用单张SVG会因Android不同密度屏幕的缩放规则导致失真，用Android Studio的Vector Asset Studio转换：

• 打开MAUI项目的Android模块，右键drawable目录 → New → Vector Asset
• 导入你的SVG Logo，工具会自动生成适配mdpi/hdpi/xhdpi等密度桶的矢量Drawable，从根源避免缩放模糊

3. 替换MAUI启动屏主题配置 #

修改Platforms/Android/AndroidManifest.xml，将默认启动屏主题替换为自定义主题：

<activity android:name="crc643f46942d9dd1fff9.MainActivity"
          android:theme="@style/CustomSplashTheme"
          android:exported="true">

在Platforms/Android/Resources/values/styles.xml中添加自定义主题：

<style name="CustomSplashTheme" parent="Theme.Maui.Splash">
  <item name="android:windowBackground">@drawable/splash_screen</item>
  <item name="android:windowFullscreen">true</item>
</style>

4. 禁用MAUI默认缩放逻辑 #

在项目的.csproj文件中配置启动屏的缩放模式为AspectFit：

<MauiSplashScreen Include="Resources\Splash\splash.svg" Scale="AspectFit" />

避坑提醒 #

• 绝对不要直接将SVG设置为windowBackground，Android会强制将其拉伸至全屏
• SVG原始尺寸建议不小于2000x2000px，避免小图放大后模糊
• 开启android:filter="false"可防止Android对矢量图做过度模糊处理

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