Flutter Android/iOS应用原生启动屏自定义背景图片的实现疑问

嘿，我完全懂你不想看到那讨厌的短暂白屏的心情！先给你吃个定心丸：不管是安卓还是iOS的原生启动屏，都完全支持设置图片作为背景，不是只能用纯色——你看到的文档里关于windowSplashScreenBackground的描述只是其中一种用法，并非限制哦～

先澄清安卓端的误解 #

你提到的windowSplashScreenBackground是Android 12+（API 31）新增的SplashScreen API里的属性，文档里说它可以用来设置纯色，但这并不代表它不能引用图片资源！这个属性其实支持传入任何drawable类型，包括你写的bitmap drawable。

分析你当前的安卓配置（兼容旧版本） #

你现在用的是Android 11及以下的传统启动屏实现方式：通过LaunchTheme的windowBackground指向launch_background.xml（bitmap），这种写法本身是有效的，但可能存在几个小问题需要调整：

1. 图片拉伸变形：你在launch_background.xml里用了android:gravity="fill"，这会强制图片填满屏幕，很容易导致图片比例失调。建议根据需求换成centerCrop（裁剪图片居中填满，保持比例）或fitXY（拉伸填满，允许变形）。
2. 多屏幕适配：要确保@drawable/paper的图片在不同分辨率的drawable目录（如drawable-mdpi、hdpi、xhdpi等）都有对应尺寸的适配资源，避免在高分辨率设备上显示模糊。
3. Android 12+的适配缺失：如果你的App要兼容Android 12及以上，仅靠旧的windowBackground可能会出现启动屏显示异常，需要结合新的SplashScreen API调整。

安卓端全版本适配方案 #

1. 适配Android 11及以下（保留你当前的写法，优化细节）

修改launch_background.xml的bitmap属性，优化显示效果：

<?xml version="1.0" encoding="utf-8"?>
<bitmap xmlns:android="http://schemas.android.com/apk/res/android"
    android:src="@drawable/paper"
    android:gravity="centerCrop" /> <!-- 替换fill为centerCrop，保持图片比例 -->

style.xml无需大改，保持当前配置即可：

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <style name="LaunchTheme" parent="@android:style/Theme.Light.NoTitleBar">
        <item name="android:windowBackground">@drawable/launch_background</item>
        <item name="android:windowSplashScreenAnimatedIcon">@null</item> <!-- Android 12+隐藏默认图标 -->
    </style>
    <style name="NormalTheme" parent="@android:style/Theme.Light.NoTitleBar">
        <item name="android:windowBackground">?android:colorBackground</item>
    </style>
</resources>

2. 适配Android 12+（API 31+）

在res/values-v31目录下新建style.xml，配置新的SplashScreen API：

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <style name="LaunchTheme" parent="@android:style/Theme.SplashScreen">
        <!-- 直接传入图片drawable作为背景，不是只能用纯色！ -->
        <item name="android:windowSplashScreenBackground">@drawable/launch_background</item>
        <!-- 关闭默认的启动图标，因为我们要用全屏图片 -->
        <item name="android:windowSplashScreenAnimatedIcon">@null</item>
        <!-- 指定启动完成后过渡到的主题 -->
        <item name="postSplashScreenTheme">@style/NormalTheme</item>
    </style>
</resources>

然后修改MainActivity.kt（或Java）添加过渡逻辑：

import android.os.Build
import android.os.Bundle
import androidx.core.splashscreen.SplashScreen.Companion.installSplashScreen
import io.flutter.embedding.android.FlutterActivity

class MainActivity : FlutterActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        // 针对Android 12+初始化新的启动屏
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
            installSplashScreen()
        }
        super.onCreate(savedInstanceState)
    }
}

iOS端的图片启动屏实现 #

iOS端同样可以轻松实现图片启动屏，避免白屏：

• 方式1：用LaunchScreen.storyboard
  打开iOS项目的LaunchScreen.storyboard，拖入一个ImageView，设置它的约束为全屏覆盖，然后选择你的背景图片作为资源，这样会自动适配所有iOS设备尺寸。
• 方式2：用LaunchImage
  在Assets.xcassets里新建LaunchImage资源集，添加对应不同设备分辨率的图片（如2x、3x、iPad版等），然后在Xcode的项目设置中，将Launch Screen File改为LaunchImage即可。

最后总结 #

1. 安卓端不管是旧版本的传统方案，还是Android 12+的新SplashScreen API，都支持图片作为启动屏背景，文档里的纯色只是可选方案之一。
2. 重点要注意图片的多屏幕适配，避免变形或模糊问题。
3. iOS端通过LaunchScreen.storyboard或LaunchImage就能实现无白屏的图片启动屏。

内容来源于stack exchange