Gradle依赖详解以及编译问题解决

依赖配置

目前 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 或a pk）。与 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 窗口打出依赖树了。

如何排除依赖

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'
}

禁用依赖传递

ompile('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 中排除和全局配置排除