Android如何解决依赖新旧迁移版ML Vision库的SDK共存及类重复问题
Android 跨版本视觉组件依赖冲突共存方案
项目背景
开发正式的Android图像处理项目时,需要将两个独立开源库整合为统一的内部依赖库,分别提供人脸检测能力、电子护照NFC读取能力。
冲突根因
两个库无法共存的核心原因是依赖了Google视觉技术栈迁移前后的新旧版本组件,具体原生依赖如下:
com.google.firebase:firebase-ml-vision:24.1.0 // 被人脸检测能力库依赖 com.google.android.gms:play-services-mlkit-text-recognition:16.1.2 // 被NFC护照读取能力库依赖
已知Google已将原firebase-ml-vision体系完整迁移到com.google.android.gms生态下,直接对人脸检测库做全量迁移改造的改造成本过高,需要低成本方案实现两个库共存。
典型编译报错
同时引入两个库后,编译阶段会触发大量重复类冲突,报错集中在视觉通用组件的内部类重复加载,典型报错如下:
Duplicate class com.google.android.gms.internal.vision.zzbl found in modules play-services-vision-common-19.1.3-runtime (com.google.android.gms:play-services-vision-common:19.1.3) and play-services-vision-face-contour-internal-16.0.0-runtime (com.google.android.gms:play-services-vision-face-contour-internal:16.0.0) Duplicate class com.google.android.gms.internal.vision.zzbn found in modules play-services-vision-common-19.1.3-runtime (com.google.android.gms:play-services-vision-common:19.1.3) and play-services-vision-face-contour-internal-16.0.0-runtime (com.google.android.gms:play-services-vision-face-contour-internal:16.0.0) Duplicate class com.google.android.gms.internal.vision.zzbo found in modules play-services-vision-common-19.1.3-runtime (com.google.android.gms:play-services-vision-common:19.1.3) and play-services-vision-face-contour-internal-16.0.0-runtime (com.google.android.gms:play-services-vision-face-contour-internal:16.0.0) Duplicate class com.google.android.gms.internal.vision.zzbp found in modules play-services-vision-common-19.1.3-runtime (com.google.android.gms:play-services-vision-common:19.1.3) and play-services-vision-face-contour-internal-16.0.0-runtime (com.google.android.gms:play-services-vision-face-contour-internal:16.0.0) Duplicate class com.google.android.gms.internal.vision.zzbq found in modules play-services-vision-common-19.1.3-runtime (com.google.android.gms:play-services-vision-common:19.1.3) and play-services-vision-face-contour-internal-16.0.0-runtime (com.google.android.gms:play-services-vision-face-contour-internal:16.0.0) Duplicate class com.google.android.gms.internal.vision.zzbr found in modules play-services-vision-common-19.1.3-runtime (com.google.android.gms:play-services-vision-common:19.1.3) and play-services-vision-face-contour-internal-16.0.0-runtime (com.google.android.gms:play-services-vision-face-contour-internal:16.0.0) Duplicate class com.google.android.gms.internal.vision.zzbs found in modules play-services-vision-common-19.1.3-runtime (com.google.android.gms:play-services-vision-common:19.1.3) and play-services-vision-face-contour-internal-16.0.0-runtime (com.google.android.gms:play-services-vision-face-contour-internal:16.0.0) Duplicate class com.google.android.gms.internal.vision.zzbt found in modules play-services-vision-common-19.1.3-runtime (com.google.android.gms:play-services-vision-common:19.1.3) and play-services-vision-face-contour-internal-16.0.0-runtime (com.google.android.gms:play-services-vision-face-contour-internal:16.0.0) Duplicate class com.google.android.gms.internal.vision.zzbx found in modules play-services-vision-common-19.1.3-runtime (com.google.android.gms:play-services-vision-common:19.1.3) and play-services-vision-face-contour-internal-16.0.0-runtime (com.google.android.gms:play-services-vision-face-contour-internal:16.0.0) Duplicate class com.google.android.gms.internal.vision.zzkf found in modules play-services-vision-common-19.1.3-runtime (com.google.android.gms:play-services-vision-common:19.1.3) and play-services-vision-face-contour-internal-16.0.0-runtime (com.google.android.gms:play-services-vision-face-contour-internal:16.0.0) Duplicate class com.google.android.gms.internal.vision.zzkh found in modules play-services-vision-common-19.1.3-runtime (com.google.android.gms:play-services-vision-common:19.1.3) and play-services-vision-face-contour-internal-16.0.0-runtime (com.google.android.gms:play-services-vision-face-contour-internal:16.0.0) Duplicate class com.google.android.gms.internal.vision.zzki found in modules play-services-vision-common-19.1.3-runtime (com.google.android.gms:play-services-vision-common:19.1.3) and play-services-vision-face-contour-internal-16.0.0-runtime (com.google.android.gms:play-services-vision-face-contour-internal:16.0.0) Duplicate class com.google.android.gms.internal.vision.zzkj found in modules play-services-vision-common-19.1.3-runtime (com.google.android.gms:play-services-vision-common:19.1.3) and play-services-vision-face-contour-internal-16.0.0-runtime (com.google.android.gms:play-services-vision-face-contour-internal:16.0.0) Duplicate class com.google.android.gms.internal.vision.zzkk found in modules play-services-vision-common-19.1.3-runtime (com.google.android.gms:play-services-vision-common:19.1.3) and play-services-vision-face-contour-internal-16.0.0-runtime (com.google.android.gms:play-services-vision-face-contour-internal:16.0.0) Duplicate class com.google.android.gms.internal.vision.zzkl found in modules play-services-vision-common-19.1.3-runtime (com.google.android.gms:play-services-vision-common:19.1.3) and play-services-vision-face-contour-internal-16.0.0-runtime (com.google.android.gms:play-services-vision-face-contour-internal:16.0.0) Duplicate class com.google.android.gms.internal.vision.zzkm found in modules play-services-vision-common-19.1.3-runtime (com.google.android.gms:play-services-vision-common:19.1.3) and play-services-vision-face-contour-internal-16.0.0-runtime (com.google.android.gms:play-services-vision-face-contour-internal:16.0.0) Duplicate class com.google.android.gms.internal.vision.zzkn found in modules play-services-vision-common-19.1.3-runtime (com.google.android.gms:play-services-vision-common:19.1.3) and play-services-vision-face-contour-internal-16.0.0-runtime (com.google.android.gms:play-services-vision-face-contour-internal:16.0.0) Duplicate class com.google.android.gms.internal.vision.zzko found in modules play-services-vision-common-19.1.3-runtime (com.google.android.gms:play-services-vision-common:19.1.3) and play-services-vision-face-contour-internal-16.0.0-runtime (com.google.android.gms:play-services-vision-face-contour-internal:16.0.0) Duplicate class com.google.android.gms.internal.vision.zzkp found in modules play-services-vision-common-19.1.3-runtime (com.google.android.gms:play-services-vision-common:19.1.3) and play-services-vision-face-contour-internal-16.0.0-runtime (com.google.android.gms:play-services-vision-face-contour-internal:16.0.0)
低成本共存实现方案
这类Google ML视觉组件跨版本依赖冲突,不需要对原有开源库做全量代码重构,可以通过Gradle统一依赖规则、冗余组件裁剪的方式实现共存,具体操作如下:
- 全局对齐视觉基础组件版本
在项目模块的build.gradle中配置全局依赖强制对齐规则,把所有视觉相关的内部依赖统一升级到最新兼容版本,从根源上避免低版本内部类与高版本内部类的包名、类名重复。核心配置如下:// 配置全局依赖解析规则 configurations.all { resolutionStrategy { // 强制统一视觉通用基础库版本,解决内部类重复 force 'com.google.android.gms:play-services-vision-common:20.1.3' force 'com.google.android.gms:play-services-vision-face-contour-internal:16.1.2' // 替换旧版Firebase ML视觉为官方迁移后的ML Kit原生组件 force 'com.google.mlkit:face-detection:16.1.5' } } - 排除传递引入的冗余冲突依赖
对两个库传递加载的冗余视觉依赖做定向排除,避免重复加载冲突类:// 引入人脸检测库时,排除旧的重复依赖 implementation('[人脸检测库的Maven坐标]') { exclude group: 'com.google.firebase', module: 'firebase-ml-vision' exclude group: 'com.google.android.gms', module: 'play-services-vision-common' } // 引入NFC护照读取库时,排除版本不一致的面部轮廓内部组件 implementation('[电子护照NFC读取库的Maven坐标]') { exclude group: 'com.google.android.gms', module: 'play-services-vision-face-contour-internal' } - 少量适配验证
旧版firebase-ml-vision的人脸检测API与新迁移后的com.google.mlkit:face-detection核心调用逻辑高度兼容,只需要对原库中少量初始化、结果回调的代码做几行适配即可。如果改造成本敏感,也可以直接通过上述强制对齐规则保证类加载一致,绝大多数场景下原库的调用逻辑不需要改动即可正常运行。
内容的提问来源于stack exchange,提问作者Yunus Karakaya
相关产品推荐
相关产品推荐

