Android 15+ Flutter应用flutter_native_splash显示黑屏问题求助

针对你遇到的Android 15（API 34+）启动页黑屏、其他版本正常的问题，可按以下步骤排查修复：

1. 升级flutter_native_splash插件到最新版本 #

旧版本插件未适配Android 15的启动屏API变更，执行以下命令升级：

flutter pub upgrade flutter_native_splash

2. 修改yaml配置，添加Android 15专属适配 #

Android 15对启动屏的资源要求有调整，需要在配置文件中明确指定Android 15的启动图配置，修改后的flutter_native_splash.yaml示例：

flutter_native_splash:
  color: "#ffc72e"
  fullscreen: true
  image: assets/images/splash/splash-dev.png
  background_image: assets/images/splash/splash-dev.png

  android_12:
    image: assets/images/splash/splash-dev.png
  # 新增Android 15适配配置
  android_15:
    image: assets/images/splash/splash-dev.png
    color: "#ffc72e" # 确保背景色与全局配置一致

3. 强制重新生成启动屏资源 #

执行命令清理旧资源并生成适配Android 15的新资源：

flutter pub run flutter_native_splash:create --force

4. 检查AndroidManifest.xml的启动主题配置 #

确保AndroidManifest中启动Activity的theme引用插件生成的适配主题，避免自定义主题冲突：

<activity
    android:name=".MainActivity"
    android:exported="true"
    android:theme="@style/LaunchTheme"
    android:configChanges="orientation|keyboardHidden|keyboard|screenSize|smallestScreenSize|locale|layoutDirection|fontScale|screenLayout|density|uiMode"
    android:hardwareAccelerated="true"
    android:windowSoftInputMode="adjustResize">

5. 验证启动图资源 #

• 确保启动图尺寸符合Android 15要求（建议使用webp格式，避免过大尺寸）
• 检查图片是否存在透明区域，Android 15启动屏对透明资源的处理逻辑有变化

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