You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Flutter 配置完成后splash screen启动页仍显示白屏问题求助

Flutter Android端启动页白屏排查方案
  • 首先排查图片命名合规性:Android drawable资源文件名仅允许小写字母、数字、下划线,且不能以数字开头,不能包含连字符、空格等特殊符号。你当前的图片命名是1-ZID-SplashScreen,既以数字开头又包含连字符,完全不符合命名规则,会导致系统无法识别该资源,这是最高概率的诱因。你需要将图片重命名为符合规则的名称,比如zid_splash_screen,同步修改launch_background.xml中android:src的取值为@drawable/zid_splash_screen即可。
  • 排查资源存放路径正确性:Android原生启动页的图片不需要在pubspec.yaml中声明,你配置的android/app/src/main/res/drawable/路径属于Android原生资源目录,Flutter的assets声明仅针对Flutter层调用的资源,该配置多余但不会直接导致白屏,可删除。同时确认你的图片确实存放在android/app/src/main/res/drawable目录下,若适配不同分辨率,需要对应放在drawable-mdpi/drawable-hdpi等分辨率目录中。
  • 排查AndroidManifest配置:确认AndroidManifest.xml中application节点下的android:theme属性,指向的主题确实配置了启动页背景,通常默认是@style/LaunchTheme,需要对应在res/values/styles.xml中确认LaunchTheme的android:windowBackground属性配置为@drawable/launch_background。
  • 清理缓存重试:修改完上述配置后,执行flutter clean清理构建缓存,再重新运行应用,避免旧的构建缓存导致配置不生效。

内容的提问来源于stack exchange,提问作者Wassef Hassine

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.06 15:27:04