VSCode中Flutter项目build.gradle构建报错求助

错误原因分析 #

这个错误通常由以下几个问题引发：

• Kotlin版本变量未定义，导致依赖解析失败
• 旧版Android SDK版本（compileSdk/targetSdk）与当前Flutter/Gradle版本不兼容
• Gradle和Android Gradle Plugin（AGP）版本不匹配

解决方案步骤 #

1. 补充Kotlin版本定义 #

在app/build.gradle文件开头添加Kotlin版本变量（选择与你Flutter版本兼容的版本，推荐1.7.x及以上）：

def kotlin_version = '1.7.10'

2. 更新Android SDK版本配置 #

修改app/build.gradle中的android闭包，将SDK版本升级到符合当前Flutter要求的数值（Flutter 3.0+建议compileSdk至少33，minSdk至少19）：

android {
    compileSdkVersion 33
    ndkVersion "25.1.8937393" // 可保留或更新为对应兼容版本

    sourceSets {
        main.java.srcDirs += 'src/main/kotlin'
    }

    lintOptions {
        disable 'InvalidPackage'
    }

    defaultConfig {
        applicationId "com.example.fitness_flutter"
        minSdkVersion 19
        targetSdkVersion 33
        versionCode flutterVersionCode.toInteger()
        versionName flutterVersionName
        testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner" // 替换为AndroidX测试 runner，旧support库已废弃
    }

    // 其余buildTypes配置保留
}

3. 替换废弃的测试依赖库 #

将旧的android.support测试库替换为AndroidX版本：

dependencies {
    implementation "org.jetbrains.kotlin:kotlin-stdlib-jdk7:$kotlin_version"
    testImplementation 'junit:junit:4.13.2'
    androidTestImplementation 'androidx.test:runner:1.5.2'
    androidTestImplementation 'androidx.test.espresso:espresso-core:3.5.1'
}

4. 同步Gradle与AGP版本 #

打开项目根目录下的android/gradle/wrapper/gradle-wrapper.properties，更新Gradle版本（需与AGP版本兼容，比如AGP 7.4.x对应Gradle 7.5-8.0）：

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

同时修改项目级android/build.gradle中的AGP和Kotlin版本：

buildscript {
    ext.kotlin_version = '1.7.10'
    repositories {
        google()
        mavenCentral()
    }

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

allprojects {
    repositories {
        google()
        mavenCentral()
    }
}

5. 清理缓存并重新构建 #

执行以下命令清理项目缓存并重新获取依赖：

flutter clean
flutter pub get

之后重新运行项目即可。

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