如何在Android应用中为不同系统版本适配同一第三方库的不同版本？

可以实现。Android App Bundle（AAB）支持按API级别拆分依赖，通过Gradle的变体配置和AAB特性拆分，就能给不同SDK版本的设备分发对应的库版本，无需提升应用的minSdkVersion。

具体Gradle配置步骤 #

1. 开启AAB的API级别拆分

在模块的build.gradle（Groovy）或build.gradle.kts（Kotlin）中配置AAB的目标SDK拆分，让构建系统能按API级别生成不同的APK切片：

android {
    bundle {
        splits {
            // 关闭不需要的拆分类型（按需调整）
            abi.enable = false
            density.enable = false
            language.enable = false
        }
        // 开启按目标SDK版本拆分
        targetSdk {
            enable = true
        }
    }
}

2. 按API级别引入对应库版本

通过Gradle的变体配置，给不同SDK级别的构建变体引入对应的库版本，避免版本冲突：

Groovy 写法

dependencies {
    // 给SDK <33的设备引入旧版本库
    implementation("com.example:third-party-lib:1.0.0") {
        version.strictly "1.0.0"
        // 仅在目标SDK <33时生效
        onlyIf {
            android.targetSdkVersion.apiLevel < 33
        }
    }

    // 给SDK >=33的设备引入最新版本库
    implementation("com.example:third-party-lib:2.0.0") {
        version.strictly "2.0.0"
        // 仅在目标SDK >=33时生效
        onlyIf {
            android.targetSdkVersion.apiLevel >= 33
        }
    }
}

Kotlin DSL 写法

dependencies {
    implementation("com.example:third-party-lib:1.0.0") {
        version {
            strictly("1.0.0")
        }
        onlyIf {
            android.targetSdkVersion.apiLevel < 33
        }
    }

    implementation("com.example:third-party-lib:2.0.0") {
        version {
            strictly("2.0.0")
        }
        onlyIf {
            android.targetSdkVersion.apiLevel >= 33
        }
    }
}

关键注意事项 #

• 确保两个版本的库API兼容：如果新版本仅新增SDK33+支持的API，未修改旧API，应用代码无需额外适配；若有API变更，需在代码中通过Build.VERSION.SDK_INT做版本判断，调用对应版本的API。
• 避免类冲突：通过version.strictly和onlyIf确保同一变体中只会引入一个版本的库。
• 验证拆分结果：构建AAB后，可使用Bundle Tool命令bundletool build-apks --bundle=your-app.aab --output=your-app.apks生成测试APK，检查不同API级别的APK切片是否包含对应的库版本。

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