VSCode中Flutter项目运行报Gradle task assembleDebug退出码1怎么解决？

首次在VS Code中使用Flutter开发应用时遇到如下报错：
FAILURE: Build failed with an exception.

• 错误位置：构建文件 C:\Users\ajgoc\Desktop\Badges\badges_gram\buddies_gram-master\android\build.gradle 第29行
• 错误信息：评估根项目 android 时出现问题

配置项目 :app 时出现问题。
无法通知项目评估监听器。

'org.gradle.api.file.DirectoryProperty org.gradle.api.file.ProjectLayout.directoryProperty(org.gradle.api.provider.Provider)'

异常提示：Exception: Gradle task assembleDebug failed with exit code 1

已尝试多种修复方法均未生效，目前模拟器中仍可加载应用，但运行的是旧版本。已提供gradle-wrapper.properties、build.gradle文件内容，以及flutter doctor -v的输出结果截图供排查。

该报错核心原因是Android Gradle插件（AGP）版本与Gradle构建工具版本不兼容，可按以下步骤修复：

1. 确认版本匹配规则
   AGP与Gradle存在严格的对应要求，常见匹配关系如下：

版本不匹配会触发对应方法找不到的运行时异常。

2. 修改配置文件统一版本

• 打开项目android/build.gradle文件，定位到第29行附近的AGP依赖声明：com.android.tools.build:gradle:x.x.x，记录x.x.x的版本号
• 打开android/gradle/wrapper/gradle-wrapper.properties文件，修改distributionUrl字段值为对应匹配版本的Gradle下载地址，比如AGP为7.4.0时修改为：

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

3. 清理缓存重新构建
   在项目根目录依次执行以下命令：

flutter clean
flutter pub get

清理完成后重新运行项目即可。

4. 特殊情况排查
   如果修改版本后仍报错，检查android/app/build.gradle中引入的第三方Flutter插件是否有更高的AGP/Gradle版本要求，统一所有依赖的版本规则即可。

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