You need to enable JavaScript to run this app. Android导入AAR遇minSdk合并冲突,如何配置overrideLibrary规则
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.26 06:54:01