降级targetSdk版本时，如何调整Android Studio默认依赖库版本？

一、这些未引入的库来源是什么？ #

• 这些默认依赖是Android Gradle Plugin（AGP）自动注入的核心库，比如AppCompat、Material、Activity、Fragment等，属于Android Studio新项目模板的默认配置组成部分。AGP会根据当前targetSdk版本自动匹配对应版本的库，当你降级targetSdk时，AGP默认关联的库版本可能与低版本targetSdk不兼容，进而触发报错。
• 另外，Android Studio的项目模板（如Empty Activity、Basic Activity）本身内置了这些基础库的依赖引用，只是没有在模块的build.gradle中显式写出，由AGP自动管理它们的版本匹配。

二、如何调整这些默认库的版本？ #

1. 显式声明依赖版本 #

在模块级build.gradle文件中，把AGP自动注入的库显式写出，并指定适配低targetSdk的版本。示例代码：

dependencies {
    // 指定适配低targetSdk的AppCompat版本
    implementation 'androidx.appcompat:appcompat:1.6.1'
    // 指定Material库版本
    implementation 'com.google.android.material:material:1.9.0'
    // 指定Activity、Fragment库版本
    implementation 'androidx.activity:activity:1.7.2'
    implementation 'androidx.fragment:fragment:1.6.2'
}

选择版本时，需确保该库版本支持你设置的targetSdk（可通过Android官方版本兼容说明确认对应匹配关系）。

2. 使用版本目录统一管理（推荐） #

在项目根目录的gradle/libs.versions.toml文件中统一声明所有依赖版本，再在模块build.gradle中引用，便于后续维护：

[versions]
appcompat = "1.6.1"
material = "1.9.0"
activity = "1.7.2"
fragment = "1.6.2"

[libraries]
androidx-appcompat = { group = "androidx.appcompat", name = "appcompat", version.ref = "appcompat" }
google-material = { group = "com.google.android.material", name = "material", version.ref = "material" }
androidx-activity = { group = "androidx.activity", name = "activity", version.ref = "activity" }
androidx-fragment = { group = "androidx.fragment", name = "fragment", version.ref = "fragment" }

模块build.gradle中引用方式：

dependencies {
    implementation libs.androidx.appcompat
    implementation libs.google.material
    implementation libs.androidx.activity
    implementation libs.androidx.fragment
}

3. 强制AGP使用指定依赖版本 #

如果不想显式声明所有依赖，可在模块build.gradle中配置版本约束，强制所有间接依赖使用指定版本：

android {
    // 其他配置...
    dependencies {
        constraints {
            // 强制所有依赖使用指定版本的AppCompat
            implementation('androidx.appcompat:appcompat') {
                version {
                    strictly '1.6.1'
                }
            }
            // 可添加其他库的版本约束
        }
    }
}

三、额外注意事项 #

• 降级targetSdk后，建议同步修改compileSdk和minSdk到对应兼容的版本，比如targetSdk设为33时，compileSdk也建议设为33，避免编译报错。
• 如果报错涉及权限或API调用，需检查代码中是否使用了高版本targetSdk专属API，替换为兼容低版本的实现。

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