flutter_native_splash在Android端无法显示启动页，iOS端正常，求排查建议

• 检查AndroidManifest.xml配置

  • 确认启动Activity的theme用的是组件生成的@style/LaunchTheme，别被自定义主题覆盖了。
  • 看看有没有加过android:windowDisablePreview="true"，这个属性会直接禁用启动页预览，删掉即可。
  • 检查theme里的windowBackground是否被手动修改，覆盖了组件生成的设置。

• 验证资源文件是否正确生成

  • 进入android/app/src/main/res目录，查看对应分辨率的drawable文件夹里，有没有组件生成的splash图片（比如launch_background.png）。
  • 打开drawable/launch_background.xml，确认里面正确引用了你的自定义图片，没有XML语法错误。

• 清理缓存重新构建

  • 先执行flutter clean清除缓存，再运行flutter pub run flutter_native_splash:create重新生成启动页资源。
  • 若Android Studio缓存导致资源不更新，直接点击File -> Invalidate Caches...清理后重启IDE。

• 排查版本兼容性

  • 确认flutter_native_splash版本和当前Flutter SDK匹配，旧版本组件可能和新Flutter不兼容，试试升级到组件最新稳定版。

• 检查Android厂商系统设置

  • 小米、华为这类国产厂商有自己的启动页机制，可能会覆盖应用自定义启动页，去手机设置里关掉“应用启动动画”类选项再测试。
  • 部分系统会优化冷启动流程，跳过自定义启动页，完全关闭应用后再重新打开试试。

• 排查插件冲突

  • 若项目里有其他涉及启动页、Activity主题的插件，先暂时禁用，测试是否恢复正常，排除冲突问题。

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