Flutter项目添加Android桌面组件时出现MinSdk错误求助

排查与修复方案 #

1. 统一配置local.properties版本参数 #

打开android/local.properties，添加或修改Flutter相关SDK版本配置，确保minSdk明确指定为21：

flutter.sdk=/你的Flutter SDK路径
flutter.minSdkVersion=21
flutter.targetSdkVersion=34
flutter.compileSdkVersion=34

保存后执行gradle同步。

2. 确认app模块build.gradle的配置完整性 #

检查android/app/build.gradle的defaultConfig块，确保minSdkVersion设置正确且无冲突：

defaultConfig {
    applicationId "你的包名"
    minSdkVersion 21
    targetSdkVersion flutter.targetSdkVersion
    versionCode flutterVersionCode.toInteger()
    versionName flutterVersionName
}

避免手动写死targetSdkVersion，优先使用Flutter提供的变量，防止版本不匹配。

3. 检查项目根目录build.gradle的全局配置 #

查看android/build.gradle中的ext全局配置块，确保minSdkVersion与app模块一致：

ext {
    compileSdkVersion = 34
    minSdkVersion = 21
    targetSdkVersion = 34
}

如果存在全局配置，需保证各模块版本统一，否则会导致gradle解析冲突。

4. 彻底清理并重建项目配置 #

执行以下命令重置项目缓存与依赖：

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

该流程会彻底清除旧的gradle缓存，重新生成配置文件，解决多数缓存导致的异常。

5. 手动触发gradle同步并查看日志 #

在Android Studio中点击工具栏的Sync Project with Gradle Files按钮，等待同步完成。若同步失败，查看Build面板的详细日志，定位具体错误（比如第三方依赖强制指定低版本minSdk）。

6. 排查第三方依赖的版本冲突 #

部分第三方依赖可能强制要求较低的minSdk版本，导致配置合并失败。执行以下命令查看所有依赖的版本信息：

cd android
./gradlew app:dependencies

找到冲突的依赖后，可升级该依赖版本，或在android/app/build.gradle中添加强制覆盖规则：

configurations.all {
    resolutionStrategy {
        eachDependency { details ->
            if (details.requested.group == '冲突依赖的组名' && details.requested.name == '冲突依赖的名称') {
                details.useVersion '兼容minSdk21的版本号'
            }
        }
    }
}

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