如何解决 Android 原生 Java 或 Kotlin 中的 AAR 元数据 minCompileSdk 错误？

解决原生 Java 或 Kotlin 中的依赖项 AAR 元数据 minCompileSdk 错误

简介

在使用原生 Java 或 Kotlin 构建 Android 应用程序时，你可能会遇到一个常见的错误：

The minCompileSdk (31) specified in a dependency's AAR metadata (META-INF/com/android/build/gradle/aar-metadata.properties) is greater than this module's compileSdkVersion (android-30).

本指南将详细介绍此错误的含义及其解决方法。

问题含义

此错误表明你依赖的某个库的最低编译 SDK 版本（minCompileSdk）高于你的项目中指定的编译 SDK 版本（compileSdkVersion）。这可能会导致应用程序在较低版本的 Android 设备上无法运行。

解决步骤

1. 检查依赖项的 minCompileSdk

• 确定出现错误的依赖项。
• 检查依赖项的元数据（META-INF/com/android/build/gradle/aar-metadata.properties）文件中指定的 minCompileSdk。

2. 调整依赖项的版本

• 如果可能，升级到依赖项的更高版本，该版本支持你的项目中指定的编译 SDK 版本。
• 如果无法升级依赖项，请尝试将 minCompileSdk 修改为与你的项目中的编译 SDK 版本相同的版本。

3. 调整项目的 compileSdkVersion

• 将项目的 compileSdkVersion 升级到与依赖项的 minCompileSdk 相同或更高的版本。
• 这将确保你的应用程序与依赖项的兼容性。

4. 使用 Android Gradle 插件版本 7.0 或更高版本

• Android Gradle 插件 7.0 或更高版本提供了自动升级依赖项 minCompileSdk 的功能。
• 在你的 gradle.properties 文件中设置以下属性：

android.enableJetifier=true

示例代码

android {
    compileSdkVersion(31)
    ...
    dependencies {
        implementation("androidx.core:core-ktx:1.7.0-alpha02")
    }
}

结论

遵循这些步骤，你可以解决原生 Java 或 Kotlin 中的依赖项 AAR 元数据 minCompileSdk 错误。确保你的依赖项版本与 Android Gradle 插件版本兼容，并及时清理和重建你的项目。

常见问题解答

Q1：为什么会出现此错误？

A1：当依赖项的 minCompileSdk 高于项目的 compileSdkVersion 时，就会出现此错误。

Q2：如何升级依赖项版本？

A2：在你的 gradle 文件中，使用 implementation 语句指定最新的依赖项版本。

Q3：如何修改依赖项的 minCompileSdk？

A3：在依赖项的元数据文件中修改 minCompileSdk 属性。

Q4：如何启用 Jetifier？

A4：在你的 gradle.properties 文件中设置 android.enableJetifier=true。

Q5：此错误如何影响我的应用程序？

A5：此错误可能会导致应用程序在较低版本的 Android 设备上无法运行。