Android导入AAR遇minSdk合并冲突,如何配置overrideLibrary规则
触发场景
在将自研AAR包作为项目模块引入后,构建流程触发Manifest合并失败,核心报错信息为:
Manifest merger failed : uses-sdk:minSdkVersion 18 cannot be smaller than version 19 declared in library [:miSDK] /mypath/build/.transforms/2f9346edc5a772d83c981ee402c3411f/mylib/AndroidManifest.xml as the library might be using APIs not available in 18 Suggestion: use a compatible library with a minSdk of at most 18, or increase this project's minSdk version to at least 19, or use tools:overrideLibrary="com.my.lib" to force usage (may lead to runtime failures)
由于存放AAR的模块没有专属Manifest文件,无法确定overrideLibrary规则的配置位置,导致构建中断。
问题本质
主项目配置的最低支持SDK版本(18),低于引入的miSDK库声明的最低支持SDK版本(19),触发Manifest合并阶段的版本兼容性校验阻断。
无风险优先解决方案
直接修改最终打包APK的主模块(通常为app模块)对应build.gradle文件中的defaultConfig配置块,将minSdkVersion从18提升至19,完全匹配库的版本要求,不会产生低版本系统的运行时兼容风险。
强制覆盖规则(overrideLibrary)的配置位置
如果业务场景强制要求保留主项目minSdkVersion=18的配置,才可使用强制覆盖逻辑,注意该操作会跳过版本兼容校验,存在低版本系统调用未适配API导致崩溃的风险。
由于自研AAR所在模块没有独立的Manifest文件,不需要在AAR模块做任何配置,直接在主模块的Manifest中添加规则即可,具体配置步骤:
- 打开主模块路径下的
src/main/AndroidManifest.xml文件 - 在
<manifest>根标签中添加tools命名空间声明:xmlns:tools="http://schemas.android.com/tools"(如果文件中已存在该声明可跳过) - 在根标签内新增
<uses-sdk>节点,写入对应库名的覆盖规则,参考代码片段:
<manifest xmlns:android="http://schemas.android.com/apk/res/android" xmlns:tools="http://schemas.android.com/tools"> <!-- 保留原有所有Manifest配置不做改动 --> <uses-sdk tools:overrideLibrary="com.my.lib" /> </manifest>
提示:tools:overrideLibrary后填写的库包名,需和报错提示中给出的库包名完全一致;存在多个需要强制覆盖的库时,多个包名之间用英文逗号分隔。
内容的提问来源于stack exchange,提问作者Ricardo
相关产品推荐
相关产品推荐

