Flutter新建项目运行报错Execution failed for task ':app:compressDebugAssets'的自动化配置方案问询

一、让新建Flutter项目自动使用指定Gradle版本 #

每次手动改配置确实够麻烦的，其实Flutter新建项目是基于SDK内置模板生成的，我们只需要修改这些模板，就能让所有新项目自动套用你需要的版本配置：

1. 找到Flutter SDK的模板目录
   打开你的Flutter SDK安装路径，进入 packages/flutter_tools/templates/app/android 文件夹。

   • Windows用户通常路径类似 C:\flutter\packages\flutter_tools\templates\app\android
   • Mac/Linux用户路径可能是 ~/flutter/packages/flutter_tools/templates/app/android

2. 修改根目录build.gradle模板
   打开 build.gradle.tmpl 文件，找到这一行：

   classpath 'com.android.tools.build:gradle:{{androidGradlePluginVersion}}'
   

   把变量 {{androidGradlePluginVersion}} 替换成你需要的版本，比如：

   classpath 'com.android.tools.build:gradle:4.0.2'
   

3. 修改Gradle Wrapper配置模板
   进入 gradle/wrapper 子文件夹，打开 gradle-wrapper.properties.tmpl 文件，找到：

   distributionUrl=https\://services.gradle.org/distributions/gradle-{{gradleVersion}}-all.zip
   

   替换成你需要的Gradle版本链接，比如：

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

4. 保存修改
   之后你再用 flutter create 命令新建项目，就会自动使用你配置好的Gradle版本，不用再手动修改了。

注意：如果之后你升级了Flutter SDK，这些模板文件可能会被覆盖，记得备份修改后的模板，或者升级后重新修改一次。

二、让新建Flutter项目兼容最新Gradle版本 #

如果你想直接用最新版Gradle解决报错问题，可以按以下步骤排查和配置：

1. 更新Flutter到最新稳定版
   首先确保你的Flutter SDK是最新的，打开终端运行：

   flutter upgrade
   

   新版本的Flutter通常会修复和最新Gradle的兼容性问题。

2. 更新Android Build Tools
   打开Android Studio，进入 File > Settings > Appearance & Behavior > System Settings > Android SDK（Mac用户是 Android Studio > Settings > Android SDK），切换到 SDK Tools 标签，勾选 Android Build Tools 并选择最新版本，点击 Apply 下载安装。

3. 匹配Gradle插件和Gradle版本
   不同版本的Android Gradle插件需要对应特定的Gradle版本，比如：

   • 插件 7.0.0 对应 Gradle 7.0.2
   • 插件 8.0.0 对应 Gradle 8.0
     你可以在项目的 android/build.gradle 里设置插件版本，同时在 gradle/wrapper/gradle-wrapper.properties 里设置对应Gradle版本，确保两者兼容。

4. 调整Android SDK版本
   在 android/app/build.gradle 里，把 compileSdkVersion 和 targetSdkVersion 更新到当前最新的API级别（比如34），这能提升和最新工具链的兼容性。

5. 清除缓存重新构建
   运行以下命令清除项目缓存，然后重新构建：

   flutter clean
   flutter pub get
   flutter run
   

6. 检查第三方依赖兼容性
   如果还是报错，可能是某个第三方pub依赖不兼容最新Gradle版本，你可以查看依赖的官方文档，更新到支持最新Gradle的版本。

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