一文完全搞清 Gradle 依赖

以前对Android Gradle构建的依赖一直傻傻分不清，这段时间正好接入集团的一个二方库，踩了不少坑，也顺带把Gradle依赖这块搞清楚了，主要整理了下Gradle依赖的类型、依赖配置、如何查看依赖、依赖冲突如何解决。

依赖类型

dependencies DSL标签是标准Gradle API中的一部分，而不是Android Gradle插件的特性，因此它不属于android标签。

依赖有三种方式，以下面的例子：

apply plugin: 'com.android.application'

android { ... }

dependencies {
    // Dependency on a local library module
    implementation project(":mylibrary")

    // Dependency on local binaries
    implementation fileTree(dir: 'libs', include: ['*.jar'])

    // Dependency on a remote binary
    implementation 'com.example.android:app-magic:12.3'
}
复制代码

1. 本地library模块依赖

implementation project(":mylibrary")
复制代码

这种依赖方式是直接依赖本地库工程代码的（须要注意的是，mylibrary的名字必须匹配在settings.gradle中include标签下定义的模块名字）。

2. 本地二进制依赖

implementation fileTree(dir: 'libs', include: ['*.jar'])
复制代码

这种依赖方式是依赖工程中的 module_name/libs/目录下的Jar文件（注意Gradle的路径是相对于build.gradle文件来读取的，因此上面是这样的相对路径）。

若是只想依赖单个特定本地二进制库，能够以下配置：

implementation files('libs/foo.jar', 'libs/bar.jar')
复制代码

3. 远程二进制依赖

implementation 'com.example.android:app-magic:12.3'
复制代码

上面是简写的方式，这种依赖完整的写法以下：

implementation group: 'com.example.android', name: 'app-magic', version: '12.3'
复制代码

group、name、version 共同定位一个远程依赖库。须要注意的点是，version 最好不要写成"12.3+"这种方式，除非有明确的预期，由于非预期的版本更新会带来构建问题。远程依赖须要在repositories标签下声明远程仓库，例如jcenter()、google()、maven仓库等。

依赖配置

目前Gradle版本支持的依赖配置有：implementation、api、compileOnly、runtimeOnly 和 annotationProcessor，已经废弃的配置有：compile、provided、apk、providedCompile。此外依赖配置还能够加一些配置项，例如AndroidTestImplementation、debugApi等等。

经常使用的是implementation、api、compileOnly三个依赖配置，含义以下：

implementation

与compile对应，会添加依赖到编译路径，而且会将依赖打包到输出（aar或apk），可是在编译时不会将依赖的实现暴露给其余module，也就是只有在运行时其余module才能访问这个依赖中的实现。使用这个配置，能够显著提高构建时间，由于它能够减小从新编译的module的数量。建议，尽可能使用这个依赖配置。

api

与compile对应，功能彻底同样，会添加依赖到编译路径，而且会将依赖打包到输出（aar或apk），与implementation不一样，这个依赖能够传递，其余module不管在编译时和运行时均可以访问这个依赖的实现，也就是会泄漏一些不该该不使用的实现。举个例子，A依赖B，B依赖C，若是都是使用api配置的话，A能够直接使用C中的类（编译时和运行时），而若是是使用implementation配置的话，在编译时，A是没法访问C中的类的。

compileOnly

与provided对应，Gradle把依赖加到编译路径，编译时使用，不会打包到输出（aar或apk）。这能够减小输出的体积，在只在编译时须要，在运行时可选的状况，颇有用。

runtimeOnly

与apk对应，gradle添加依赖只打包到APK，运行时使用，但不会添加到编译路径。这个没有使用过。

annotationProcessor

与compile对应，用于注解处理器的依赖配置，这个没用过。

查看依赖树

能够查看单个module或者这个project的依赖，经过运行依赖的Gradle任务，以下：

一、View -> Tools Windows -> Gradle（或者点击右侧的Gradle栏）；

二、展开 AppName -> Tasks -> android，而后双击运行AndroidDependencies。运行完，就会在Run窗口打出依赖树了。

依赖冲突解决

随着不少依赖加入到项目中，不免会出现依赖冲突，出现依赖冲突如何解决？

定位冲突

依赖冲突可能会报相似下面的错误：

Program type already present com.example.MyClass
复制代码

经过查找类的方式（command + O）定位到冲突的依赖，进行排除。

如何排除依赖

一、dependencies中排除（细粒度）

compile('com.taobao.android:accs-huawei:1.1.2@aar') {
        transitive = true
        exclude group: 'com.taobao.android', module: 'accs_sdk_taobao'
}
复制代码

二、全局配置排除

configurations {
    compile.exclude module: 'cglib'
    //全局排除原有的tnet jar包与so包分离的配置，统一使用aar包中的内容
    all*.exclude group: 'com.taobao.android', module: 'tnet-jni'
    all*.exclude group: 'com.taobao.android', module: 'tnet-so'
}
复制代码

三、禁用依赖传递

compile('com.zhyea:ar4j:1.0') {
    transitive = false
}

configurations.all {
    transitive = false
}
复制代码

还能够在单个依赖项中使用@jar标识符忽略传递依赖：

compile 'com.zhyea:ar4j:1.0@jar'
复制代码

四、强制使用某个版本

若是某个依赖项是必需的，而又存在依赖冲突时，此时不必逐个进行排除，可使用force属性标识须要进行依赖统一。固然这也是能够全局配置的：

compile('com.zhyea:ar4j:1.0') {
    force = true
}

configurations.all {
    resolutionStrategy {
        force 'org.hamcrest:hamcrest-core:1.3'
    }
}
复制代码

五、在打包时排除依赖

先看一个示例：

task zip(type: Zip) {
    into('lib') {
        from(configurations.runtime) {
            exclude '*unwanted*', '*log*'
        }
    }
    into('') {
        from jar
        from 'doc'
    }
}
复制代码

代码表示在打zip包的时候会过滤掉名称中包含“unwanted”和“log”的jar包。这里调用的exclude方法的参数和前面的例子不太同样，前面的参数可能是map结构，这里则是一个正则表达式字符串。

也可使用在打包时调用include方法选择只打包某些须要的依赖项：

task zip(type: Zip) {
    into('lib') {
        from(configurations.runtime) {
            include '*ar4j*', '*spring*'
        }
    }
    into('') {
        from jar
        from 'doc'
    }
}
复制代码

主要是使用dependencies中排除和全局配置排除。

reference