Flutter原生闪屏(flutter_native_splash)图片不显示问题排查

补充Android 10及以下版本的专属配置 #

你的当前配置仅针对Android 12做了单独设置，但Android 10（API 29）属于Android 12以下版本，需要补充适配参数来确保图片正常加载：

flutter_native_splash:
  android: true
  ios: true
  color: "#ffffff"
  image: assets/icon.png
  android_gravity: center # 控制Android 10及以下图片居中，同时解决拉伸问题
  android_12:
    color: "#ffffff"
    image: assets/icon.png
    android_12_gravity: center # Android 12同步设置居中

验证启动主题的资源关联 #

确认android/app/src/main/AndroidManifest.xml中activity的主题@style/LaunchTheme，其对应的styles.xml文件未覆盖闪屏的背景配置：

<!-- res/values/styles.xml中的LaunchTheme -->
<style name="LaunchTheme" parent="@android:style/Theme.Light.NoTitleBar">
    <item name="android:windowBackground">@drawable/launch_background</item>
</style>

该launch_background是插件自动生成的资源文件，请勿手动修改，通过pubspec配置即可控制其内容。

重新生成并同步闪屏资源 #

修改配置后必须执行以下命令，确保资源和配置完全同步：

flutter pub run flutter_native_splash:create
flutter clean
flutter build apk

检查图片基础规格 #

确保你的icon.png符合Android资源规范：

• 尺寸建议不小于192x192px，保证不同分辨率屏幕下的显示效果
• 图片比例尽量为正方形，避免适配时的变形问题

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