一、前言
在開發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.lxweimin.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包之外,還需要引用其中需要的第三方庫,否則會報錯。