Flutter Android项目启动白屏问题

白屏现象

首先,我们使用Android Studio创建一个Flutter项目。运行项目,我们先会看到先闪过一个白屏,然后再进入计数器页面。

那么问题来了,为什么是白屏,而不是黑屏或者其他颜色呢?

我们打开android项目,打开AndroidManifest.xml可以看到配置启动的主题@style/LaunchTheme,点击打开styles.xml

xml 复制代码
<?xml version="1.0" encoding="utf-8"?>
<resources>
    <!-- Theme applied to the Android Window while the process is starting when the OS's Dark Mode setting is off -->
    <style name="LaunchTheme" parent="@android:style/Theme.Light.NoTitleBar">
        <!-- Show a splash screen on the activity. Automatically removed when
             the Flutter engine draws its first frame -->
        <item name="android:windowBackground">@drawable/launch_background</item>
    </style>
</resources>

点击@drawable/launch_background打开launch_background.xml,可以看到设置的背景为white。

xml 复制代码
<?xml version="1.0" encoding="utf-8"?>
<!-- Modify this file to customize your launch splash screen -->
<layer-list xmlns:android="http://schemas.android.com/apk/res/android">
    <item android:drawable="@android:color/white" />
​
    <!-- You can insert your own image assets here -->
    <!-- <item>
        <bitmap
            android:gravity="center"
            android:src="@mipmap/launch_image" />
    </item> -->
</layer-list>

解决方式

我们以京东APP为例,通过解压后,找到启动图uh.9.png,该图不能直接使用,将图片拖入绘图后保存使用。

可以看到图片尺寸为718*1278,我们在res目录下创建drawable-xhdpi文件夹

使用layer-list

使用截图软件,截取启动图中间图片和底部的图片放入drawable-xhdpi,吸取背景颜色#FA2B18

修改launch_background.xml

xml 复制代码
<?xml version="1.0" encoding="utf-8"?><!-- Modify this file to customize your launch splash screen -->
<layer-list xmlns:android="http://schemas.android.com/apk/res/android">
​
    <item>
        <shape>
            <solid android:color="#FA2B18" />
        </shape>
    </item>
​
    <item android:bottom="100dp">
        <bitmap
            android:gravity="center"
            android:src="@drawable/center" />
    </item>
​
    <item android:bottom="30dp">
        <bitmap
            android:gravity="bottom"
            android:src="@drawable/bottom" />
    </item>
​
</layer-list>

效果

使用.9图

将完整图launch_image.png片放入drawable-xhdpi,点击右键,弹窗选择Create 9-Path file,创建launch_image.9.png,然后删除旧的图片,只保留.9图。

绘制原则

  1. 上边左右各绘制1px,距离边缘至少1px
  2. 左边上下绘制200px,距离边缘至少1px(取200px的原因:当屏幕显示导航栏时,图片显示的高度变小,可以上下减小图片高度,防止变形)

直接修改styles.xml主题中的背景使用.9图

xml 复制代码
<?xml version="1.0" encoding="utf-8"?>
<resources>
    <!-- Theme applied to the Android Window while the process is starting when the OS's Dark Mode setting is off -->
    <style name="LaunchTheme" parent="@android:style/Theme.Light.NoTitleBar">
        <!-- Show a splash screen on the activity. Automatically removed when
             the Flutter engine draws its first frame -->
        <item name="android:windowBackground">@drawable/launch_image</item>
    </style>
</resources>

效果

相关推荐
Zsnoin能18 小时前
Flutter仿ios液态玻璃效果
flutter
傅里叶1 天前
iOS相机权限获取
flutter·ios
Haha_bj1 天前
Flutter—— 本地存储(shared_preferences)
flutter
心之语歌1 天前
Flutter 存储权限:适配主流系统
flutter
恋猫de小郭1 天前
Android 官方正式官宣 AI 支持 AppFunctions ,Android 官方 MCP 和系统级 OpenClaw 雏形
android·前端·flutter
MakeZero2 天前
Flutter那些事-布局篇
flutter
王码码20352 天前
Flutter for OpenHarmony:socket_io_client 实时通信的事实标准(Node.js 后端的最佳拍档) 深度解析与鸿蒙适配指南
android·flutter·ui·华为·node.js·harmonyos
zhangkai2 天前
flutter存储知识点总结
flutter·ios
一个假的前端男2 天前
# 从零开始创建 Flutter Web 项目(附 VS Code 插件推荐)
前端·flutter·react.js
一个假的前端男2 天前
[特殊字符] Flutter 安装完整指南 Windows—— 2026最新版
windows·flutter