Flutter Android端flutter_native_splash插件执行flutter run报错求助

可能的原因及修复步骤 #

1. 检查启动图资源合规性 #

• 确保启动图文件名仅用小写字母、数字和下划线，禁止大写、空格或特殊字符
• 图片格式需为Android支持的类型（如PNG、WebP），避免HEIC等非兼容格式
• 核对pubspec.yaml中配置的启动图路径，确保拼写无错误

2. 清理构建缓存并重新同步 #

依次执行以下命令：

flutter clean
flutter pub get
cd android
./gradlew clean
./gradlew build --refresh-dependencies
cd ..
flutter run

3. 手动指定Gradle版本 #

若系统提示Gradle已是最新但实际版本不符，手动更新配置：

• 打开android/gradle/wrapper/gradle-wrapper.properties，修改distributionUrl为最新稳定版：

  distributionUrl=https\://services.gradle.org/distributions/gradle-8.4-all.zip
  

• 打开android/build.gradle，更新对应版本的Android Gradle Plugin（AGP）：

  dependencies {
      classpath 'com.android.tools.build:gradle:8.1.4'
      // 保留其他原有依赖
  }
  

• 执行flutter clean后重新运行项目

4. 排查插件配置错误 #

检查pubspec.yaml中的flutter_native_splash配置：

• 确认color参数为标准十六进制值（如#FFFFFF）
• 若配置了Android 12专属启动图，确保资源路径和格式符合系统要求

5. 降级插件版本 #

若当前插件版本与Flutter版本不兼容，尝试降级：

• 修改pubspec.yaml中的插件版本为稳定旧版：

  dependencies:
    flutter_native_splash: ^2.3.11
  

• 执行flutter pub get后重新生成启动图并运行

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