在IntelliJ IDEA中构建目标SDK28的Android项目遇依赖错误求助

1. 分离compileSdk与targetSdk版本 #

Android编译系统允许compileSdk使用高版本（满足依赖的最低要求），同时保持targetSdk=28，这样既兼容依赖的编译要求，又不改变APP的运行时行为（targetSdk才决定系统对APP的限制逻辑）。

修改模块级build.gradle（或build.gradle.kts）：

android {
    compileSdk 34 // 选择依赖要求的最高版本，比如34
    defaultConfig {
        minSdk 28
        targetSdk 28
        // 其他配置如applicationId、versionCode等
    }
    // 其余配置不变
}

同步项目后重新编译即可，这是最稳妥的方案，不会引入兼容性风险。

2. 降级依赖到兼容compileSdk28的版本 #

逐个定位报错的依赖，查找它们支持compileSdk28的历史版本替换：

• 例如com.google.android.material:material，若当前版本要求compileSdk31，可降级到1.4.0（该版本支持compileSdk28）
• 可通过依赖的官方文档或Maven仓库的版本列表确认兼容版本
• 替换后同步项目，重新编译

3. 临时禁用AAR元数据检查（不推荐） #

如果前两种方法无法落地，可临时关闭AGP的元数据校验，但可能隐藏运行时兼容性问题（比如依赖调用了targetSdk28以上的API），仅建议用于临时测试：

方案A（AGP 7.0+） #

android {
    // 其他配置...
    dependencies {
        components {
            all {
                allVariants {
                    withVariantDependencies { deps ->
                        deps.each { dep ->
                            dep.attributes.remove(AndroidAttributes.ANDROID_API)
                            dep.attributes.remove(AndroidAttributes.TARGET_SDK)
                        }
                    }
                }
            }
        }
    }
}

方案B（禁用lint检查） #

android {
    // 其他配置...
    lintOptions {
        abortOnError false
        disable 'MissingTargetSdkVersion', 'GradleCompatible'
    }
}

4. 排查并排除依赖的强制约束 #

部分依赖会通过transitive依赖强制要求高版本compileSdk，可通过依赖树定位后排除：

1. 执行命令查看依赖树：

   # macOS/Linux
   ./gradlew app:dependencies
   # Windows
   gradlew.bat app:dependencies
   

2. 找到强制要求高compileSdk的依赖，在引入时排除相关约束：

   implementation('com.example:problem-dependency:1.0.0') {
       exclude group: 'androidx.core', module: 'core-ktx'
       // 根据依赖树调整排除的group和module
   }
   

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