咨询Flutter/Android冷启动时完全替换默认'F'启动页的可行方案

在最新版Flutter（3.x+）和Android（API 21+）环境下，完全可以彻底替换引擎启动时的默认'F'启动页，核心是通过正确配置Android层的启动屏逻辑，避免Flutter默认启动资源的加载。以下是适配当前版本的实操步骤：

一、移除Flutter默认启动页配置 #

1. 打开Android项目下的android/app/src/main/res/values/styles.xml，找到继承自Theme.FlutterLauncher的启动主题（通常名为Theme.AppLauncher），直接将其替换为自定义启动主题，或修改现有主题的windowBackground属性。
2. 删除或重写默认的launch_background.xml文件（位于res/drawable目录），彻底移除Flutter的'F'图标示例：

<?xml version="1.0" encoding="utf-8"?>
<layer-list xmlns:android="http://schemas.android.com/apk/res/android">
    <!-- 自定义启动屏背景色 -->
    <item android:drawable="@color/splash_bg" />
    <!-- 可选：添加自定义中心图标 -->
    <!-- <item>
        <bitmap
            android:gravity="center"
            android:src="@drawable/your_custom_logo" />
    </item> -->
</layer-list>

二、使用Android官方Splash Screen API（推荐适配Android 12+） #

从Android 12（API 31）开始，官方推出的Splash Screen API可以实现更流畅的启动过渡，Flutter 3.0+已完美支持：

1. 在android/app/build.gradle中确保配置：

android {
    compileSdkVersion 34
    defaultConfig {
        targetSdkVersion 34
        // ...其他配置
    }
}

2. 在styles.xml中创建启动主题，继承Theme.SplashScreen：

<style name="Theme.App.Splash" parent="Theme.SplashScreen">
    <!-- 启动屏背景色 -->
    <item name="android:windowBackground">@color/splash_bg</item>
    <!-- 自定义启动图标（支持自适应图标） -->
    <item name="windowSplashScreenAnimatedIcon">@drawable/your_adaptive_icon</item>
    <!-- 图标动画时长，建议和Flutter初始化时长匹配 -->
    <item name="windowSplashScreenAnimationDuration">300</item>
    <!-- 启动完成后切换到的应用主题 -->
    <item name="postSplashScreenTheme">@style/Theme.App</item>
</style>

3. 修改AndroidManifest.xml，将主Activity的android:theme设置为上述自定义启动主题：

<activity
    android:name=".MainActivity"
    android:exported="true"
    android:theme="@style/Theme.App.Splash"
    android:configChanges="orientation|keyboardHidden|keyboard|screenSize|smallestScreenSize|locale|layoutDirection|fontScale|screenLayout|density|uiMode"
    android:hardwareAccelerated="true"
    android:windowSoftInputMode="adjustResize">
    <!-- ...其他配置 -->
</activity>

4. 在Flutter的main.dart中同步启动屏动画时长，避免提前切换界面导致闪屏：

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  // 等待Android启动屏动画完成，或执行必要的初始化操作
  await Future.delayed(const Duration(milliseconds: 300));
  runApp(const MyApp());
}

三、低版本Android兼容（API < 31） #

针对Android 11及以下设备，使用传统的layer-list启动屏配置：

1. 在res/values/styles.xml中创建兼容主题：

<style name="Theme.App.Splash.Legacy" parent="Theme.Material.Light.NoActionBar">
    <item name="android:windowBackground">@drawable/legacy_splash_background</item>
    <item name="android:windowFullscreen">true</item>
</style>

2. 通过tools:targetApi或资源目录（如values-v31、values）区分版本配置主题，确保低版本设备加载兼容启动屏。

四、验证关键注意事项 #

• 确保主Activity未使用Theme.FlutterLauncher相关默认主题，完全由自定义启动主题接管。
• 冷启动测试需杀掉应用进程后重新打开，避免热启动缓存干扰结果。
• 不要在Flutter引擎初始化完成前渲染Flutter界面，确保启动屏完全由Android层控制。

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