在VSCode中运行Flutter应用至安卓模拟器时构建失败

• 校验Flutter环境完整性
  执行flutter doctor命令，排查Android SDK、许可证、相关组件的安装状态，按照提示修复所有异常项。若出现Android许可证未接受的提示，运行flutter doctor --android-licenses完成许可证同意流程。

• 清理构建缓存并重建
  依次执行以下命令清理项目缓存，重新拉取依赖并构建：

  flutter clean
  flutter pub get
  cd android && ./gradlew clean
  cd .. && flutter run
  

• 对齐Android SDK版本配置
  打开项目android/app/build.gradle文件，确保compileSdkVersion和targetSdkVersion与本地已安装的Android SDK版本一致。示例配置：

  android {
      compileSdkVersion 34
      defaultConfig {
          targetSdkVersion 34
          // 其他默认配置项
      }
  }
  

• 更新Gradle相关版本

  1. 打开android/build.gradle，更新Gradle插件版本至兼容的稳定版：

     buildscript {
         dependencies {
             classpath 'com.android.tools.build:gradle:7.4.2'
             classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
         }
     }
     

  2. 修改android/gradle/wrapper/gradle-wrapper.properties中的Gradle分发地址，匹配插件对应的版本：

     distributionUrl=https\://services.gradle.org/distributions/gradle-7.5-bin.zip
     

• 排查依赖冲突
  运行flutter pub deps查看项目依赖树，定位是否存在依赖版本冲突问题。若有冲突，可在pubspec.yaml中通过dependency_overrides强制指定兼容版本。

• 重置运行环境
  重启Android模拟器和VSCode，排除环境状态异常导致的构建失败。

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