flutter_native_splash启动页仅显白/黑屏，图片不加载问题求助

1. 核对图片资源配置 #

• 确认assets/images/Minda.png文件真实存在，文件名大小写完全匹配（iOS、macOS系统区分文件名大小写）
• 在pubspec.yaml的flutter节点下正确声明资源，二选一即可：

  flutter:
    # 方式1：单独声明图片
    assets:
      - assets/images/Minda.png
    # 方式2：声明整个目录（包含目录下所有资源）
    # assets:
    #   - assets/images/
  

• 执行flutter pub get刷新资源索引

2. 检查图片格式与尺寸 #

• 必须使用PNG格式图片，JPG等格式无法被插件正确处理
• Android 12+对启动图有特殊要求：建议使用1125x1125px的正方形透明背景图，适配系统自适应图标逻辑
• 普通Android/iOS启动图原始尺寸不能过小，避免生成后模糊或不显示

3. 修正插件配置 #

移除冗余配置，确保语法正确（注意使用正常双引号，而非转义的"）：

flutter_native_splash:
  web: false
  color: "#ffffff"
  image: "assets/images/Minda.png"
  android_12:
    color: "#ffffff"
    image: "assets/images/Minda.png"

如果深色模式不需要单独设置启动图，可直接省略color_dark和image_dark项

4. 彻底清理并重新生成启动页 #

先手动清理旧的启动页文件，避免缓存干扰：

flutter clean
# 清理iOS旧启动图资源
rm -rf ios/Runner/Assets.xcassets/LaunchImage.imageset
# 清理Android旧启动页配置与图片
rm -rf android/app/src/main/res/drawable/launch_background.xml
rm -rf android/app/src/main/res/mipmap-*/launch_image.png

再重新执行生成命令：

flutter pub get
flutter pub run flutter_native_splash:create

5. 验证平台配置 #

• Android：打开android/app/src/main/AndroidManifest.xml，确认启动Activity的android:theme指向插件生成的主题（如@style/LaunchTheme），没有手动修改启动页配置
• iOS：打开Xcode，检查Runner/Assets.xcassets中是否存在插件生成的LaunchImage，同时确认Info.plist里的启动页配置指向该资源

6. 彻底卸载旧应用后重装 #

从测试设备或模拟器上完全卸载旧应用，再安装新构建的版本，避免旧缓存导致的显示异常

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