Gradle 使用技巧 (四) - 如何定位和解决依赖冲突

本贴最后更新于 2278 天前,其中的信息可能已经时过境迁

1. 前言

随着业务的复杂度加深,我们免不了要引入许多的第三方开源库,也不可避免的会出现依赖冲突的错误。最常见的是 V7、V4 包之间的冲突。

2. 如何定位依赖冲突

解决依赖冲突很简单,难得是如何去定位是引入的哪个库导致的依赖冲突。
如果只想看结果的可以直接跳到最后。

2.1. 排除法

排除法很简单,但是很耗时,就是选择一个依赖一个依赖的注释、编译、看结果。当然这也是最傻的办法,我们开发者怎么能做这种繁琐的工作呢?(说得我好像我自己没做过似的。。滑稽)

2.2. Gradle Task

Android Studio 虽然给我们提供了一个依赖树,但也只是一个总的平面图,并不是十分的直观。

Android Studio 依赖树

External Libraries 只给我们提供了一个依赖结果,并没有指出是哪个依赖依赖了什么东西。

所幸,Gradle 提供了一个 task:androidDependencies,这个 task 能在命令行中显示依赖树之间的依赖关系。

找到 androidDependencies task,每一个 module 下面都有相应的 androidDependencies。

task 位置

双击执行后就能在命令行中打印相关的依赖信息了,这里为了演示,我新建了一个项目。

命令行执行结果

如上图,可以看到不同的 buildType 的所有信息都打印出来了,比如 release:

release
releaseCompileClasspath - Dependencies for compilation
+--- com.android.support:appcompat-v7:26.1.0@aar
+--- com.android.support.constraint:constraint-layout:1.1.2@aar
+--- com.android.support:animated-vector-drawable:26.1.0@aar
+--- com.android.support:support-vector-drawable:26.1.0@aar
+--- com.android.support:support-v4:26.1.0@aar
+--- com.android.support:support-media-compat:26.1.0@aar
+--- com.android.support:support-fragment:26.1.0@aar
+--- com.android.support:support-core-utils:26.1.0@aar
+--- com.android.support:support-core-ui:26.1.0@aar
+--- com.android.support:support-compat:26.1.0@aar
+--- com.android.support:support-annotations:26.1.0@jar
+--- com.android.support.constraint:constraint-layout-solver:1.1.2@jar
+--- android.arch.lifecycle:runtime:1.0.0@aar
+--- android.arch.lifecycle:common:1.0.0@jar
\--- android.arch.core:common:1.0.0@jar

当然,这只是一个刚刚新增的项目,信息才这么少,如果是维护很久了的项目,那么信息将会让人眼花。

我们可以改为用命令行的方式打印信息,还可以进行相关的配置,配置的方法为:-q --configuration 依赖类型,如下就是打印 implementation 类型的依赖

./gradlew app:dependencies -q --configuration implementation

可以看到,结果明显精简了很多

执行结果

但是,我们仍然看不出什么东西是吧?所以,请看下一步

2.3. 引入插件

前面说了,作为一个开发者,怎么能做那么多繁琐的事情呢?所以这里有个插(wu)件(qi)

可以直接通过面板的形式看到是哪个依赖库,具体是冲突了哪个版本。

插件截图

该插件的适应方式比较简单,就不多讲了。

3. 如何解决冲突

3.1. jar 包冲突

这是最简单的,删除其中一个 jar 包。

3.2. 在明确的知道是哪个库的哪些依赖的情况下

可以使用 exclude 来去除传递依赖,如下:

3.2.1 exclude group

根据包名来过滤,下面的配置是:过滤包名"com.android.support"的所有依赖

androidTestCompile('com.android.support.test.espresso:espresso-core:2.2.2', {
        exclude group: 'com.android.support'
    })

3.2.2 exclude module

根据模块名称来过滤下面的配置是过滤"support-annotations"这个模块

androidTestCompile('com.android.support.test.espresso:espresso-core:2.2.2', {
        exclude module: 'support-annotations'
    })

3.3. 不知道是哪个库的传递依赖导致冲突

这种情况最常见,我不想去找,也不想去逐个排除,那么就有以下两种方案:

3.3.1 一劳永逸法

直接统一指定 transitive,就是为给 dependencies 配置 transitive 为 false,这样就会以你当前依赖的版本为准。但是最好不要使用这种方式。

...
configurations.all {
   transitive = false
}
...
dependencies{
}

需要注意的是 configurations 和 android、dependencies 节点是处于同一级的。

3.3.2 逐个指定

哪个冲突指定哪个。具体可以查看我另外一篇文章 Gradle 之强制依赖某个第三方库

configurations.all {
    resolutionStrategy.force "com.android.support:appcompat-v7:22.2.1"
}

指定依赖

最后

未完待续、敬请期待!
免为其难的关注一下公众号吧!!

生活实在是太苦啦

FullScreenDeveloper

  • B3log

    B3log 是一个开源组织,名字来源于“Bulletin Board Blog”缩写,目标是将独立博客与论坛结合,形成一种新的网络社区体验,详细请看 B3log 构思。目前 B3log 已经开源了多款产品:SymSoloVditor思源笔记

    1063 引用 • 3453 回帖 • 203 关注
  • Android

    Android 是一种以 Linux 为基础的开放源码操作系统,主要使用于便携设备。2005 年由 Google 收购注资,并拉拢多家制造商组成开放手机联盟开发改良,逐渐扩展到到平板电脑及其他领域上。

    334 引用 • 323 回帖 • 2 关注
  • Gradle
    41 引用 • 20 回帖 • 2 关注

相关帖子

欢迎来到这里!

我们正在构建一个小众社区,大家在这里相互信任,以平等 • 自由 • 奔放的价值观进行分享交流。最终,希望大家能够找到与自己志同道合的伙伴,共同成长。

注册 关于
请输入回帖内容 ...