AppCompat 1.7.0是否新增minSdkVersion≥21要求？技术咨询

问题背景 #

应用minSdkVersion为19，长期使用AppCompat库，升级至1.7.0版本后编译失败，报错如下：

Manifest merger failed : uses-sdk:minSdkVersion 19 cannot be smaller than version 21 declared in library [androidx.appcompat:appcompat-resources:1.7.0] /home//.gradle/caches/transforms-4/xxxxxxxx/transformed/appcompat-resources-1.7.0/AndroidManifest.xml as the library might be using APIs not available in 19
Suggestion: use a compatible library with a minSdk of at most 19,
or increase this project's minSdk version to at least 21,
or use tools:overrideLibrary="androidx.appcompat.resources" to force usage (may lead to runtime failures)

官方AppCompat 1.7.0文档（含1.6.0以来变更章节）未提及该minSdk提升要求，疑问点包括：此变更是否为未记录的破坏性更新、是否为Bug、后续是否会修复，以及是否必须在提升minSdk或停留在旧版本中二选一。

核心原因 #

这是未记录的破坏性变更，并非Bug。AppCompat 1.7.0中，其拆分出的子库androidx.appcompat:appcompat-resources被单独提升了minSdkVersion至21，原因是该版本对资源加载模块进行了底层优化，引入了仅API 21及以上版本支持的资源API，官方文档未同步更新此变更说明。

可选解决方案（无需二选一） #

你不必仅局限于提升minSdk或停留在旧版本，以下两种方案更灵活：

方案1：强制覆盖库的minSdk限制（谨慎使用） #

按照报错提示，在AndroidManifest.xml中添加强制兼容配置：

1. 确保根标签已声明tools命名空间：

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools">

2. 在<application>标签外，与<uses-sdk>同级添加：

<uses-sdk tools:overrideLibrary="androidx.appcompat.resources" />

注意：此方式可能引发API 19设备的运行时崩溃，因为库内确实依赖了API 21+特性。仅当你的App在低版本设备上仅使用AppCompat基础功能（如主题、基础控件）时，可先进行全面测试；若使用了动态资源加载、矢量图兼容等高级功能，大概率会出现异常。

方案2：锁定appcompat-resources版本为1.6.1 #

在Module级build.gradle中，单独指定appcompat-resources的版本为1.6.1，让AppCompat 1.7.0依赖旧版本的资源库：

dependencies {
    implementation 'androidx.appcompat:appcompat:1.7.0'
    // 强制使用minSdk=19的1.6.1版本资源库
    implementation 'androidx.appcompat:appcompat-resources:1.6.1'
}

此方案更稳妥，既保留AppCompat 1.7.0的新特性，又维持对API 19的兼容。后续升级AppCompat版本时，需同步确认appcompat-resources的版本兼容性。

关于后续修复情况 #

目前AndroidX团队已收到大量类似反馈，很大概率会在1.7.x的补丁版本（如1.7.1）中回滚appcompat-resources的minSdk限制，或补全文档说明。可关注AndroidX官方更新日志动态。

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