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

flutter_native_splash包启动页背景图失效,请求技术帮助

问题描述

我希望使用flutter_native_splash包将一张PNG图片设置为启动页背景而非图标,各项配置均已完成,但背景图始终无法正常显示。我尝试调整图片分辨率但无效,已在资源文件中正确配置该图片(可正常作为图标使用),仅背景图设置失败,能否提供帮助?

当前pubspec.yaml中的配置片段:

flutter_native_splash:
  android: true
  ios: true
  web: false
  color: "#42a5f5" // Just test
  background_image: "assets/splash.png"
  android_12:
解决方案

按以下步骤排查修复:

  1. 修正YAML配置注释格式
    YAML不支持//注释,将配置里的// Just test改为# Just test,避免配置解析错误:

    color: "#42a5f5" # Just test
    
  2. 补充Android 12+的背景图配置
    Android 12及以上版本的启动页配置是独立的,需单独指定背景图,否则会沿用默认样式,在android_12节点下添加内容:

    android_12:
      image: "assets/splash.png"
      color: "#42a5f5" # 可选,与全局color保持一致即可
    
  3. 重新生成启动页资源
    执行命令重新生成各平台启动页资源:

    flutter pub run flutter_native_splash:create
    
  4. 清理缓存并重启项目

    • 清理Flutter缓存:flutter clean
    • 重启IDE后重新运行项目,避免旧资源缓存干扰显示
  5. 再次确认图片配置
    确保pubspec.yaml的flutter -> assets节点已正确声明该图片资源:

    flutter:
      assets:
        - assets/splash.png
    

    图片尺寸建议:Android端至少1080x1920像素,iOS端至少2732x2732像素(适配Retina屏),避免因尺寸问题导致显示异常

内容的提问来源于stack exchange,提问作者Can Gönülaçar

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.06.24 01:35:57