使用native_splash_screen时安卓端启动页不显示，iOS正常

问题场景 #

使用flutter_native_splash插件配置启动页后，iOS端可正常展示，但Android端启动页无法显示，当前配置如下：

flutter_native_splash: 
  background_image: "packages/components/assets/splash1x.png"
  android_12:
    image: "packages/components/assets/splash1x.png"
  android: true
  ios: true

排查与解决步骤 #

• 确认资源有效性
  检查packages/components/assets/splash1x.png文件是否存在，且项目pubspec.yaml已正确声明依赖的components包。同时确保图片为Android兼容的PNG格式，尺寸适配常见屏幕密度。

• 重新生成启动页资源
  执行插件生成命令，确保Android端资源被正确生成：

  flutter pub run flutter_native_splash:create
  

  若之前生成过资源，可先清除再重新生成：

  flutter pub run flutter_native_splash:remove
  flutter pub run flutter_native_splash:create
  

• 检查Android 12配置适配
  Android 12+的启动页配置需符合系统尺寸要求，单张图片可能因适配问题不显示。可暂时移除android_12节点，使用通用配置测试是否正常；若保留该配置，建议提供多密度适配的图片资源。

• 验证Android项目配置
  打开Android项目的AndroidManifest.xml，确认启动Activity的主题为@style/LaunchTheme，未被手动修改。同时检查res/drawable、res/drawable-v31目录下是否存在生成的启动页资源文件，缺失则说明生成过程异常。

• 清理项目缓存
  执行清理命令后重新编译：

  flutter clean
  flutter pub get
  flutter run
  

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