Android新项目引入旧版jar包编译报错，无法使用新特性如何解决？

该问题是旧版Android Gradle插件（AGP 3.6.4）与新版构建特性的兼容性冲突导致：涉及的.jar包基于Java 1.8编译，升级AGP后默认字节码规则、核心库支持规则变更会触发旧.jar包编译报错，可通过以下步骤修复，既保留旧.jar包的可用性，也支持view binding、data binding等新特性。

1. 匹配升级AGP与Gradle版本 #

首先升级根目录build.gradle中的AGP版本到支持新特性的稳定版，示例用适配性较好的7.4.2版本：

buildscript {
    dependencies {
        // 替换原有3.6.4的配置
        classpath 'com.android.tools.build:gradle:7.4.2'
    }
}

修改gradle/wrapper/gradle-wrapper.properties中的Gradle版本，和AGP版本保持对应：

distributionUrl=https\://services.gradle.org/distributions/gradle-7.5-bin.zip

2. 全局配置Java 1.8字节码兼容性 #

在模块级build.gradle（通常是app模块）的android闭包中添加编译版本配置：

android {
    compileSdk 33
    defaultConfig {
        // 原有配置
        minSdk 21
        targetSdk 33
        multiDexEnabled true
    }

    compileOptions {
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8
        // 开启核心库脱糖，兼容旧jar包对Java 8+API的调用
        coreLibraryDesugaringEnabled true
    }

    // 项目使用Kotlin时添加该配置
    kotlinOptions {
        jvmTarget = "1.8"
    }
}

在同文件的dependencies闭包中添加脱糖依赖：

dependencies {
    coreLibraryDesugaring 'com.android.tools:desugar_jdk_libs:2.0.4'
    // 保留原有jar包引入配置
    implementation fileTree(dir: 'libs', include: ['*.jar'])
}

3. 开启View Binding与Data Binding #

在模块级build.gradle的android闭包中添加构建特性配置：

android {
    // 原有配置
    buildFeatures {
        viewBinding true
        dataBinding true
    }
}

4. 冲突排查（可选） #

如果仍然存在编译报错，执行./gradlew app:dependencies命令查看依赖树，排查是否存在旧.jar包和其他依赖的类重复冲突，对重复的依赖组使用exclude规则移除即可：

implementation('xxx:xxx:1.0.0') {
    exclude group: 'com.xxx.xxx', module: 'xxx'
}

配置完成后先清理构建缓存：

• 执行Android Studio菜单File > Invalidate Caches > Invalidate and Restart
• 命令行执行./gradlew clean，再重新构建项目即可

• 不要随意修改旧.jar包的内部字节码，优先通过上述配置兼容的方案解决问题
• 确保所有模块的compileOptions配置统一，避免不同模块字节码版本不一致导致的运行时崩溃

内容的提问来源于stack exchange，提问作者Mustafa Maden