一、前言
在开发Android的过程中经常使用到Gradle依赖,这里就总结一下Gradle依赖管理中的一些用法。主要内容包括Gradle从仓库中查找依赖、Gradle关键字的使用。 每个模块都可能依赖其他模块,模块之间的依赖可以使用命令行gradle dependencies来查看。
二、从仓库中查找依赖
Gradle从仓库中查找依赖的规则是这样的: 首先需要确定仓库的类型,究竟是Maven仓库还是Ivy仓库。如果是Maven仓库,则会去寻找.pom文件;如果是Ivy仓库,则会去寻找ivy.xml文件。
Note:从Gradle 5.0开始,会优先去寻找.module文件。在Gradle 5.0之前,如果上述的文件不存在,则直接会找模块文件(如:xxx.jar);在Gradle 5.0之后,则不会找模块文件。
三、Gradle关键字
1、Transitive关键字
Transitive关键字用于处理子依赖项,默认为true。当为true时,gradle会自动添加子依赖项,形成一个多层树形结构;当为false时,则需要手动添加每个依赖项。
我们可以统一指定transitive为false,如下面所示:
configurations.all {
transitive =false
}
dependencies {
compile fileTree(dir: 'libs', include: ['*.jar'])
compile 'com.android.support:appcompat-v7:27.1.0'
compile 'com.android.support.constraint:constraint-layout:1.0.2'
testCompile 'junit:junit:4.12'
androidTestCompile 'com.android.support.test:runner:1.0.1'
androidTestCompile 'com.android.support.test.espresso:espresso-core:3.0.1'
}
同时也可以单个指定transitive,如下面所示:
dependencies {
compile fileTree(dir:'libs', include: ['*.jar'])
compile 'com.android.support:appcompat-v7:27.1.0'
compile 'com.android.support.constraint:constraint-layout:1.0.2'
testCompile 'junit:junit:4.12'
androidTestCompile 'com.android.support.test:runner:1.0.1'
androidTestCompile ('com.android.support.test.espresso:espresso-core:3.0.1') {
transitive = false
}
}
2、provided关键字
provided的意思是在编译提供这个包,让编译不会出错。但是实际上它的引用依赖中没有这个包,所以需要在app中提供这个包的引用,否则在运行app时会出错。举个例子(引用自http://www.jianshu.com/p/8ae94b825740):
A 、B、C都是Library。
A依赖了C,B也依赖了C
App需要同时使用A和B
那么其中A(或者B)可以修改与C的依赖关系为Provided
A这个Library实际上还是要用到C的,只不过它知道B那里也有一个C,自己再带一个就显得多余了,等app开始运行的时候,A就可以通过B得到C,也就是两个库公用这个C。所以自己就在和B汇合之前,假设自己有C。如果运行的时候没有C,肯定就要崩溃了。
所以说,Provided是间接的得到了依赖的Library,运行的时候必须要保证这个Library的存在,否则就会崩溃。而使用provided起到了避免依赖重复资源的作用。
provided可以和@jar关键字组合在一起,表示提供一个jar包。 provided可以和@aar关键字组合在一起,表示提供一个aar包。
provided也可以不显式指定关键字,即通过provided group:module这样的形式调用(注意后面没有@jar或者@aar)。这个时候需要定位到.module、.pom文件、.Ivy文件,然后根据其中的引用去寻找相应的jar包或者aar包(寻找的策略暂时还不清楚)。
provided还可以和files组合将本地的jar包作为引用。例如在项目的libs下有一个名为test.jar的jar包,我们可以这样引用provided files('libs/test.jar')
。那么这个jar包仅仅作为编译使用,而不会添加依赖到library中。
2、compile关键字
compile和provided的用法是一样的,它们之间区别最大的地方在于compile会将组件的引用依赖写入到.module、.pom、.Ivy文件中,然后在编译或者运行时,会使用到引用依赖的版本。
@jar
一般@jar可以和compile、provided联合使用,比如说compile group:module@jar,provided group:module@jar等,这表示仅将依赖作为jar包进行使用。
@aar
aar类型是带有资源的压缩包,它能和compile、provided联合使用,比如说compile group:module@aar、provided group:module@aar。
加入aar的意思是:只引用了group:module这个组件,而group:module引用的其他组件没有被引用。举个例子:如果aar中引用了第三方的lib,那么打包后的aar中是没有把这些第三方库加入到aar的引用依赖中,所以如果app中除了引用这个aar包之外,还需要引用其中需要的第三方库,否则会报错。