Flutter应用Android 12+中使用layer-list/Theme.SplashScreen时启动页Logo被裁剪的解决咨询

看起来你碰到了Android启动页Splash Screen里Layer List导致Logo被裁剪的典型问题，我来帮你一步步梳理解决思路，亲测有效的方案如下：

1. 修正Layer List的Bitmap核心配置 #

你遇到的裁剪问题，本质是Layer List里的Bitmap默认会按原生像素尺寸绘制，如果Logo资源本身尺寸过大或者系统自动缩放后超出屏幕可用空间，就会被侧边裁剪。要解决这个，你需要给Bitmap添加明确的缩放、居中规则：

<?xml version="1.0" encoding="utf-8"?>
<layer-list xmlns:android="http://schemas.android.com/apk/res/android">
    <!-- 琥珀色背景层 -->
    <item android:drawable="@color/amber_500" />
    <!-- Logo层：关键配置确保不裁剪 -->
    <item>
        <bitmap
            android:gravity="center"
            android:src="@drawable/ic_app_logo"
            android:scaleType="fitCenter"
            android:width="240dp"
            android:height="240dp" />
    </item>
</layer-list>

• android:gravity="center"：强制Logo在屏幕正中央，不会偏移
• android:scaleType="fitCenter"：让Logo按比例缩放到你指定的宽高范围内，不会拉伸或超出
• android:width/height：用dp值指定Logo的显示大小（根据你的Logo比例调整，比如正方形用240dp，长方形按比例设置）

2. 正确配置Android 12+的Theme.SplashScreen #

很多人会忽略Theme.SplashScreen的配套属性，导致Layer List的配置不生效：

在res/values-v31/styles.xml中修改你的启动主题：

<style name="LaunchTheme" parent="Theme.SplashScreen">
    <!-- 琥珀色背景（如果Layer List已经包含背景，这里可以省略，保持颜色一致即可） -->
    <item name="windowSplashScreenBackground">@color/amber_500</item>
    <!-- 指定你的Layer List作为启动页内容 -->
    <item name="windowSplashScreenContent">@drawable/launch_splash</item>
    <!-- 动画时长，建议匹配Flutter初始化的大致时间 -->
    <item name="windowSplashScreenAnimationDuration">2000</item>
    <!-- 启动完成后切换到的应用主题 -->
    <item name="postSplashScreenTheme">@style/AppTheme</item>
</style>

注意：如果你的Layer List已经包含背景层，不要重复设置windowSplashScreenBackground，避免出现双重背景导致的显示异常。

3. Android 11及以下兼容主题修正 #

对于低版本系统，确保你的 fallback 主题（res/values/styles.xml）正确指向Layer List，同时不要添加强制拉伸的属性：

<style name="LaunchTheme" parent="@android:style/Theme.Light.NoTitleBar">
    <item name="android:windowBackground">@drawable/launch_splash</item>
    <item name="android:windowFullscreen">true</item>
</style>

低版本系统会直接读取windowBackground的Layer List，所以核心还是依赖第一步的Bitmap配置。

4. 资源密度适配：容易被忽略的关键点 #

如果你的Logo资源放在了通用的drawable目录下，系统会默认按mdpi密度缩放，在高分辨率屏幕上会被放大很多倍，导致裁剪。请把Logo放在对应的密度目录：

• 比如1080x1080像素的Logo，放在drawable-xxhdpi
• 1440x1440像素的Logo，放在drawable-xxxhdpi
  这样系统会根据屏幕密度自动适配，避免不必要的放大。

5. 更简单的替代方案：直接使用系统SplashScreen图标API #

如果Layer List的配置还是有问题，你可以跳过Layer List，直接用Theme.SplashScreen的原生图标属性，系统会自动处理缩放和居中，完全避免裁剪：

<style name="LaunchTheme" parent="Theme.SplashScreen">
    <item name="windowSplashScreenBackground">@color/amber_500</item>
    <!-- 直接设置Logo，系统自动适配所有屏幕 -->
    <item name="windowSplashScreenIcon">@drawable/ic_app_logo</item>
    <item name="windowSplashScreenAnimationDuration">2000</item>
    <item name="postSplashScreenTheme">@style/AppTheme</item>
</style>

这个方案只适用于Android 12+，低版本还是需要用Layer List的方式。

最后验证步骤 #

• 执行flutter clean，删除android/app/build目录
• 卸载设备上的应用，然后用flutter run --release运行（Debug模式可能有缓存残留）
• 检查设备开发者选项中的“不保留活动”是否关闭，这个选项会导致启动页状态异常

内容来源于stack exchange