【Android】Suggestion: use tools:overrideLibrary="" to force usage

关注

原创最新推荐文章于 2026-02-28 19:50:03 发布 3.4w 阅读 AI 写同款· GEO 优化 ›

合并多个清单文件 AndroidManifest.xml tools:node=“replace“ uses-sdk tools:overrideLibrary APK 或 Android App Bundle 文件只能包含一个 AndroidManifest.xml 文件，但 Android Studio 项目可以包含多个清单文件，这些清单文件由主源代码集、build 变体和导入的库提供。因此，在构建应用时，Gradle 构建系统会将所有清单文件合并成一个清单文件打包到应用中。清单合并工具遵循某些合并启发法和您使用特殊 XML 属性定义的合并偏好设置，来将各个清单文件中的所有 XML 元素组合在一起。阅读详情

异常提示：

应用在Android Studio Build的时候，抛出了如下异常：

Error:Execution failed for task ‘:app:processDebugManifest’.
> Manifest merger failed : uses-sdk:minSdkVersion 8 cannot be smaller than version 9 declared in library [jp.wasabeef:blurry:1.0.0] /Users/xxx/xxx/app/build/intermediates/exploded-aar/jp.wasabeef/blurry/1.0.0/AndroidManifest.xml
Suggestion: use tools:overrideLibrary=”jp.wasabeef.blurry” to force usage

错误原因：

出现这个错误的原因是我引入的第三方库最低支持版本高于我的项目的最低支持版本，异常中的信息显示：我的项目的最低支持版本为8（Android 2.2），而第三方库的最低支持版本为9（Android 2.3），所以抛出了这个异常。

解决办法：

在AndroidManifest.xml文件中标签中添加<uses-sdk tools:overrideLibrary="xxx.xxx.xxx"/>，其中的xxx.xxx.xxx为第三方库包名，如果存在多个库有此异常，则用逗号分割它们，例如：<uses-sdk tools:overrideLibrary="xxx.xxx.aaa, xxx.xxx.bbb"/>，这样做是为了项目中的AndroidManifest.xml和第三方库的AndroidManifest.xml合并时可以忽略最低版本限制。