gradle依赖implementation，api，compileOnly，compile及依赖管理

新旧依赖对比

Android studio 版本更新至3.0时，连带着com.android.tools.build:gradle 插件工具也升级到了3.0.0，在插件3.0.0中使用了最新的Gralde 4.0 里程碑版本作为gradle 的编译版本，该版本gradle编译速度有所加速，更加欣喜的是，完全支持Java8。当然，对于Kotlin的支持，在这个版本也有所体现，Kotlin插件默认是安装的。依赖关键字也有所改变：

Android Studio 3.X	Android Studio 2.X
runtimeOnly	apk
compileOnly	provided
api	compile
implementation	没有对应
debugImplementation	debugCompile
releaseImplementation	releaseCompile
androidTestImplementation	androidTestCompile
testImplementation	testCompile
annotationProcessor	android-apt

区别和解释

注意compile是和api对应的，使用效果相同；

依赖传递和打包

implementation

对于使用了该命令编译的依赖，对该项目有依赖的项目将无法访问到使用该命令编译的依赖中的任何程序，也就是将该依赖隐藏在内部，而不对外部公开。使用implementation来进行依赖，这会大大改善工程的构建时间；只有你明确要向外部暴露所依赖lib的接口时，才需要使用api依赖，整体来说，会减少很多重新编译；也就是依赖不传递；

api（compile）

这种是我们最常用的方式，使用该方式依赖的库将会参与编译和打包；例如：A moudle依赖了B moudle，B moudle中使用api依赖了C库，则A也可以使用C库中的接口。依赖传递；

compileOnly（provided）

只在编译时有效，不会参与打包，可以在自己的moudle中使用该方式依赖；比如com.android.support，gson这些使用者常用的库，避免冲突；

runtimeOnly（apk）

只在生成apk的时候参与打包，编译时不会参与，很少用；

androidTestImplementation （androidtestCompile）

androidTestImplementation 只在单元测试代码的编译以及最终打包测试apk时有效；

debugImplementation （debugCompile）

debugImplementation 只在debug模式的编译和最终的debug apk打包时有效；

releaseImplementation （releaseCompile）

releaseImplementation 仅仅针对Release模式的编译和最终的Release apk打包；

说明：

1，compile在3.x版本的gradle中已被废弃，将在2018年底，被google移除，所以不建议再使用compile了；

2，依赖首先应该设置为implementation，如果没有错误，那就用implementation ，如果有错，那么使用api指令；

3，注意以上关键字的依赖作用范围，以免发生依赖冲突；

依赖冲突

添加依赖的三种方式

第一种（只添加一种依赖，全部写全）： implementation "group":"io.reactivex.rxjava3","name":"rxandroid","version":"3.0.0"

第二种（只添加一种依赖，简写）： implementation ('io.reactivex.rxjava3:rxandroid:3.0.0') 或者 implementation 'io.reactivex.rxjava3:rxandroid:3.0.0'

第三种（添加多种依赖）： implementation ( "org.springframework:spring-core:5.2.5.RELEASE", "org.springframework:spring-beans:5.2.5.RELEASE" )

exclude group和exclude module

使用exclude排除依赖的时候只能排除jar包下面的直接依赖，而不能跨级排除，否则排除是不生效的。

// 依据构建名称排除 exclude module: 'cglib'

// 依据组织名称排除 exclude group: 'org.jmock'

// 依据组织名称+构件名称排除 exclude group: 'org.unwanted', module: 'iAmBuggy'

例如：

compile('org.hibernate:hibernate:3.1') { 　　　　
    //如果有冲突，强制使用3.1版本 　　　　
    force = true

　　//排除传递中的依赖 　　　　
    exclude module: 'cglib'   //通过artifact的名字排除 　　　　
    exclude group: 'org.jmock'  //通过artifact的group名字排除 　　　　
    exclude group:'org.unwanted', module: 'iAmBuggy'  //通过artifact的名字和grop名字排除

　　//禁止该依赖传递 　　　　
    transitive = false 
}

Gradle命令查看依赖树

查看项目中库的依赖关系

./gradlew :app:dependencies –configuration compile
或
gradlew :app:dependencies –configuration compile

查看库中的依赖树

./gradlew :app:dependencyInsight –dependency butterknife –configuration compile
或
gradlew :app:dependencyInsight –dependency butterknife –configuration compile

说明： 

1，在Window系统下，无需使用./开头，直接使用gradlew即可。gradlew其实就是gradlew.bat文件，如果执行时，提示 'gradlew' 不是内部或外部命令，说明当前你的项目没有gradlew.bat这个文件；

2，执行app模块下的dependencies任务；额外配置compile,编译环境下的依赖项。

3，通过gradle -q [项目名]:dependencies 命令查看依赖树，可以比较直观的看到冲突。

依赖管理

依赖排除几种方式：

Gradle依赖排除 | ZY笔记

annotationProcessor和kapt

看懂编译注解annotationProcessor和kapt - 简书