Android Studio启动即报AAR元数据检查错误，调整SDK后错误增多

• 统一SDK版本匹配
  当前compileSdk设置为31，但targetSdk仅为30，版本不匹配会触发元数据校验逻辑异常。将targetSdk调整为与compileSdk一致的31：

  defaultConfig {
      applicationId "com.example.lifecycle"
      minSdk 21
      targetSdk 31
      versionCode 1
      versionName "1.0"
  
      testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
  }
  

• 排查依赖库的SDK适配问题
  AAR元数据错误大多源于依赖库的minSdk要求高于项目配置，或是依赖库编译用的SDK版本与项目冲突：

  1. 执行命令./gradlew app:dependencies（Windows环境用gradlew.bat app:dependencies），导出所有依赖的详细信息，定位冲突的依赖库。
  2. 针对冲突库，要么升级/降级到适配项目SDK版本的库版本；若确认版本兼容，可在模块build.gradle中添加强制依赖配置：

     android {
         configurations.all {
             resolutionStrategy {
                 force 'com.example:conflicting-library:x.y.z' // 替换为实际冲突库的坐标
             }
         }
     }
     

• 清理缓存并重新同步项目

  1. 点击Android Studio菜单栏File -> Invalidate Caches...，选择Invalidate and Restart清除缓存并重启IDE。
  2. 点击右上角Sync Project with Gradle Files按钮重新同步项目。

• 匹配Android Gradle Plugin（AGP）版本
  compileSdk 31需要适配AGP 7.0及以上版本，检查项目根目录build.gradle中的AGP版本：

  buildscript {
      dependencies {
          classpath 'com.android.tools.build:gradle:7.0.4' // 选择适配compileSdk31的AGP版本
      }
  }
  

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