Android Gradle编译失败：需升级compileSdkVersion至32及以上

编译报错信息 #

有一个或多个插件需要更高版本的Android SDK。
请在I:\StratejiSoft\android\app\build.gradle中添加以下配置以修复问题：
android {
  compileSdkVersion 33
  ...
}


FAILURE: 构建因异常失败。

* 出错原因：
任务':app:checkDebugAarMetadata'执行失败。
> 执行com.android.build.gradle.internal.tasks.CheckAarMetadataWorkAction时发生失败
   > 检查AAR元数据值时发现一个或多个问题：

     依赖项'androidx.appcompat:appcompat-resources:1.5.1'要求'compileSdkVersion'设置为32或更高。
     模块':app'的编译目标为'android-31'

     依赖项'androidx.appcompat:appcompat:1.5.1'要求'compileSdkVersion'设置为32或更高。
     模块':app'的编译目标为'android-31'

     依赖项'androidx.webkit:webkit:1.5.0'要求'compileSdkVersion'设置为32或更高。
     模块':app'的编译目标为'android-31'

     依赖项'androidx.emoji2:emoji2-views-helper:1.2.0'要求'compileSdkVersion'设置为32或更高。
     模块':app'的编译目标为'android-31'

     依赖项'androidx.emoji2:emoji2:1.2.0'要求'compileSdkVersion'设置为32或更高。
     模块':app'的编译目标为'android-31'

* 尝试方案：
> 使用--stacktrace选项获取堆栈跟踪信息。
> 使用--info或--debug选项获取更多日志输出。
> 使用--scan选项获取完整分析报告。

* 更多帮助请访问https://help.gradle.org

BUILD FAILED in 1s
Exception: Gradle任务assembleDebug执行失败，退出代码1

问题描述 #

我没试全所有代码，但总是碰到不同报错。已经多次修改版本号，问题还是存在，而且两天前项目还能正常编译，求解决办法。

解决步骤 #

1. 统一配置SDK版本
   打开I:\StratejiSoft\android\app\build.gradle，找到android代码块，将compileSdkVersion和targetSdkVersion都设置为33（或满足要求的更高版本）：

   android {
       compileSdkVersion 33
       defaultConfig {
           targetSdkVersion 33
           // 保留原有其他配置
       }
       // 保留原有其他配置
   }
   

2. 适配Gradle插件版本
   打开项目根目录的build.gradle文件，确保Gradle插件版本与compileSdkVersion匹配，例如适配33的插件版本可以用7.4.2：

   dependencies {
       classpath 'com.android.tools.build:gradle:7.4.2'
       // 保留原有其他依赖
   }
   

3. 清除缓存并重新构建
   • 在Android Studio中点击File -> Invalidate Caches... -> Invalidate and Restart
   • 或者在项目根目录终端执行命令：

     ./gradlew clean
     ./gradlew assembleDebug
     

4. 锁定依赖版本（针对自动升级导致的问题）
   如果是依赖库自动升级引发的冲突，可以直接指定兼容旧SDK版本的依赖版本：

   dependencies {
       implementation 'androidx.appcompat:appcompat:1.4.2'
       implementation 'androidx.webkit:webkit:1.4.0'
       implementation 'androidx.emoji2:emoji2:1.1.0'
       // 保留原有其他依赖
   }
   

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