Flutter仅背景图启动页：禁用默认启动页及flutter_native_splash失效解决

一、禁用Flutter默认启动页 #

Flutter的默认启动页是原生层的启动界面，需针对Android和iOS分别修改：

Android端 #

1. 打开android/app/src/main/res/drawable/launch_background.xml文件
2. 替换为仅包含自定义背景图的配置：

<?xml version="1.0" encoding="utf-8"?>
<layer-list xmlns:android="http://schemas.android.com/apk/res/android">
    <!-- 背景色，可与图片底色一致 -->
    <item android:drawable="@color/your_bg_color" />
    <item>
        <bitmap
            android:gravity="center"
            android:src="@drawable/your_splash_image" />
    </item>
</layer-list>

3. 确保android/app/src/main/AndroidManifest.xml中，主Activity的android:theme指向包含该启动背景的主题（默认是@style/LaunchTheme）
4. 可选：删除mipmap目录下的默认启动图标，避免残留显示

iOS端 #

1. 打开Xcode，进入项目Runner目录
2. 进入Assets.xcassets，删除默认的LaunchImage组
3. 添加自定义启动图资源，创建新的Launch Image集并适配各分辨率设备
4. 若使用LaunchScreen.storyboard，直接修改storyboard中的背景为自定义图片；若使用Launch Image，确保Info.plist中UILaunchImageFile配置正确

二、无法禁用默认启动页的替代方案 #

若原生层默认启动页因兼容性无法完全消除，可采用以下过渡方案：

• Flutter层无缝过渡页：在Flutter初始化阶段，先显示与原生启动页完全一致的全屏图片页面，初始化完成后跳转首页。示例代码：

void main() {
  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(home: const SplashScreen());
  }
}

class SplashScreen extends StatefulWidget {
  const SplashScreen({super.key});

  @override
  State<SplashScreen> createState() => _SplashScreenState();
}

class _SplashScreenState extends State<SplashScreen> {
  @override
  void initState() {
    super.initState();
    // 替换为实际初始化逻辑，如加载资源、接口请求等
    Future.delayed(const Duration(milliseconds: 300), () {
      Navigator.pushReplacement(context, MaterialPageRoute(builder: (_) => const HomePage()));
    });
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      body: Container(
        width: double.infinity,
        height: double.infinity,
        decoration: const BoxDecoration(
          image: DecorationImage(
            image: AssetImage('assets/splash_bg.png'),
            fit: BoxFit.cover,
          ),
        ),
      ),
    );
  }
}

• 强化一致性：确保原生启动页与Flutter过渡页的背景图、颜色完全匹配，让用户无感知切换

三、flutter_native_splash包未达预期的排障步骤 #

1. 校验配置文件：检查pubspec.yaml中的配置是否正确，示例：

flutter_native_splash:
  color: "#ffffff"
  image: assets/splash.png
  # Android配置
  android: true
  android_12:
    image: assets/splash_android12.png
    color: "#ffffff"
  # iOS配置
  ios: true

2. 重新生成启动页：执行flutter pub run flutter_native_splash:create，确保命令无报错
3. 清理项目缓存：
   • Android：执行flutter clean，再在Android Studio中点击Build > Clean Project
   • iOS：执行flutter clean，删除ios/Pods目录后重新执行pod install
4. 检查资源有效性：确认配置的图片路径正确，文件存在且已在pubspec.yaml的assets节点中声明
5. 适配Android 12+：Android 12及以上版本需单独配置android_12项，否则启动页可能不生效
6. 重置原生文件：若手动修改过原生启动页文件，需删除后重新执行生成命令，避免自定义代码覆盖包生成的配置

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