Flutter项目Gradle同步及构建APK/AAB失败问题求助

1. 对齐Android Gradle插件与Gradle版本 #

你当前用的AGP 4.0.0和Gradle 7.2不兼容，这是核心问题。AGP 4.0.0对应的Gradle版本范围是6.1.1-6.7，调整步骤：

• 打开android/gradle/wrapper/gradle-wrapper.properties，修改distributionUrl：

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

• 打开android/build.gradle，保持AGP版本为4.0.0（和Flutter 2.0.6适配）：

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

2. 清理缓存解决FlutterTask注解问题 #

Flutter 2.0.6和高版本Gradle的适配问题会导致assets相关注解报错，回退到兼容的Gradle版本后，执行以下清理操作：

flutter clean
cd android && ./gradlew clean

之后重新构建：

flutter build apk --release

3. 配置fastStart参数（若仍有相关报错） #

如果还出现fastStart未配置的提示，在android/app/build.gradle的buildTypes中添加配置：

android {
    // 已有配置保留
    buildTypes {
        release {
            // 已有release配置保留
            fastStart true
        }
    }
}

4. 确认Java版本配置 #

你当前用的Java 11.0.20和Flutter 2.0.6兼容，只需确保Android Studio的JDK路径正确：

• 打开Android Studio → File → Project Structure → SDK Location → JDK Location，选择Java 11的安装路径。

5. 调整Kotlin版本（可选） #

如果出现Kotlin相关报错，可降级到Flutter 2.0.6默认推荐的Kotlin 1.4.32：

• 在android/build.gradle中修改：

  ext.kotlin_version = '1.4.32'
  

完成以上调整后，重新执行APK/AAB构建命令即可。

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