Flutter Android启动屏真机黑屏：如何统一设置为白色？

可能的问题点及解决方法： #

• 多分辨率资源目录未统一配置
  Android会根据设备的分辨率、API等级加载对应目录下的资源文件。你仅修改了res/drawable/launch_background.xml，但真机可能加载了res/drawable-v21/、res/drawable-hdpi/等其他子目录下的同名文件。检查这些目录，如果存在launch_background.xml，统一将其背景色修改为@android:color/white。

• NormalTheme窗口背景覆盖启动图
  你配置的NormalTheme可能默认窗口背景为黑色，冷启动阶段会先显示主题背景，再加载启动屏资源。打开res/values/styles.xml找到NormalTheme，确保它的windowBackground指向你的启动屏配置或直接设为白色：

  <style name="NormalTheme" parent="@android:style/Theme.Light.NoTitleBar">
      <item name="android:windowBackground">@drawable/launch_background</item>
  </style>
  

  若主题父类为深色系（如Theme.DeviceDefault），也会导致背景变黑，建议切换为浅色父主题。

• 真机缓存残留
  真机可能保留了旧APK的缓存数据，卸载当前应用，清理手机应用缓存后，重新安装打包好的APK。

• Flutter初始化逻辑干扰
  检查main函数中是否过早设置了深色主题，这可能导致启动屏过渡阶段显示黑色，但该情况一般不会影响原生启动屏的显示。

内容的提问来源于stack exchange，提问作者Ten Digit Grid