Android依赖冲突：解决 androidx.activity 要求 compileSdk ≥34 的问题

问题描述

当在 Android Studio 中创建新项目并运行时，出现以下错误：

An issue was found when checking AAR metadata:

1. Dependency 'androidx.activity:activity:1.8.0' requires libraries and applications that
   depend on it to compile against version 34 or later of the
   Android APIs.
   
   :app is currently compiled against android-33.
   
   Also, the maximum recommended compile SDK version for Android Gradle
   plugin 8.0.2 is 33.

该错误的产生原因是：

• 项目使用的 com.google.android.material:material:1.10.0 库依赖 androidx.activity:activity:1.8.0
• androidx.activity:activity:1.8.0 要求编译版本至少为 Android API 34 (Android 14)
• 项目当前配置的 compileSdk 为 33 (Android 13)
• 当前 Android Gradle 插件版本 (8.0.2) 最高支持的 compileSdk 版本为 33，无法直接升级

项目依赖配置如下：

dependencies {
    implementation 'androidx.appcompat:appcompat:1.6.1'
    implementation 'com.google.android.material:material:1.10.0' // 问题来源
    implementation 'androidx.constraintlayout:constraintlayout:2.1.4'
    implementation 'com.github.bumptech.glide:glide:4.16.0'
    testImplementation 'junit:junit:4.13.2'
    androidTestImplementation 'androidx.test.ext:junit:1.1.5'
    androidTestImplementation 'androidx.test.espresso:espresso-core:3.5.1'
}

解决方案

✅ 推荐方案：升级 compileSdk 至 34（主流做法）

前置步骤

升级前请确保 Android Studio 已更新至 2023.2.1+ 版本（可通过 Help > Check for Updates 检查更新）

1. 修改模块级 build.gradle (/app/build.gradle)：

android {
    namespace 'com.example.yourpackage'
    // 关键修改：从 33 改为 34
    compileSdk 34
    // 可选：同步更新 targetSdk
    defaultConfig {
        applicationId "com.example.yourpackage"
        minSdk 24
        targetSdk 34  // 修改此项
        // ...
    }
    // ...
}

2. 升级项目级 build.gradle (/build.gradle)：

dependencies {
    // 升级 Android Gradle Plugin
    classpath 'com.android.tools.build:gradle:8.2.0' // 升级至支持 API 34 的版本
    // ...
}

3. 点击 Sync Now 同步 Gradle 配置

兼容性说明

• targetSdk 不需要必须升级到 34
• 仅升级 compileSdk 可保持应用行为与之前一致
• minSdk 可保持原有版本不影响最低支持设备

⚠ 备选方案：降级 Material 库版本（临时方案）

如果不适合立即升级 compileSdk，可降级 Material Design 库：

dependencies {
    implementation 'com.google.android.material:material:1.9.0' // 降级到 1.9.0
    // 其他依赖保持不变...
}

库版本对照表

建议在 Maven Central 检查以下版本对应关系：

Material 版本	要求最低 compileSdk	绑定 Activity 版本
1.10.0	34+ (Android 14)	1.8.0+
1.9.0	33 (Android 13)	1.7.2
1.8.0	33 (Android 13)	1.7.1

🛠 高级：排除特定依赖（专家方案）

通过排除冲突的 androidx.activity 模块解决：

implementation('com.google.android.material:material:1.10.0') {
    exclude group: 'androidx.activity', module: 'activity'
}

风险提示

此方法可能导致运行时异常，仅当项目已包含兼容的 activity 库版本时使用（如通过 androidx.appcompat:appcompat 引入）。需严格测试稳定性

解决方案对比

方案	优势	劣势	推荐指数
升级到 compileSdk 34	使用最新库特性 符合 Android 开发规范	需升级 Gradle 插件 可能有新 API 适配工作	⭐⭐⭐⭐
降级到 material:1.9.0	无需修改 SDK 版本 简单快速解决	无法使用最新 Material 特性 临时解决方案	⭐⭐⭐
从依赖中排除 activity	保持库版本不变	可能导致运行时报错 依赖关系不透明	⭐

核心原理分析

此问题本质是 Gradle 的依赖传递机制引发的：

• compileSdk ≠ targetSdk：
  编译 SDK 只影响开发环境可使用的 API，与应用安装设备范围无关
  minSdk 才决定应用可安装的设备最低版本

• 依赖传递规则：
  Android 库可以声明对编译环境的最低要求

最佳实践建议

1. 定期更新开发环境

   • 每季度检查 Android Studio 更新
   • 使用 Lint 工具检测过时依赖

2. 优先使用推荐解决方案

   # 推荐工作流程
   Android更新 → Gradle插件升级 → SDK升级 → 依赖库更新

3. 验证库兼容性

   ./gradlew app:dependencies

   查看完整的依赖树，避免传递依赖冲突

长期管理建议

• 在版本控制系统的 .idea/gradle.xml 中加入 .gitignore
• 避免团队协作用户开发环境版本不同步导致编译问题

根据以上任一方案操作后，重新构建项目即可解决此错误。开发中建议优先采用升级 SDK 的方案以获得完整的依赖库支持。