You need to enable JavaScript to run this app. Android如何解决依赖新旧迁移版ML Vision库的SDK共存及类重复问题
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.11.13 00:54:02