Android三方依賴衝突Gradle中exclude的使用

2022-09-08 18:04:12

一、場景

Android專案的開發過程中，我們專案中的gradle的dependencies閉包中會引入很多三方依賴庫，引入的庫越多，越容易產生庫之間的依賴衝突。

列舉衝突的場景：

1、同一個依賴庫引入多個版本；
2、重複引入了同一個依賴庫；

編譯報錯資訊一般為：Program type already present

二、如何檢視專案中的三方依賴？

方案一： Gradle task工具檢視

按照如圖目錄找到dependencise雙擊，會在Run控制檯輸出列印。

結果如下：

方案二：Terminal控制檯檢視

在windows上Android studio Terminal中使用這個命令：

gradlew :app:dependencies

在MacOS中使用下面的命令：

gradlew :app:dependencies

其中的“app”為module名稱。

這個命令會將gradle執行的各個步驟都列印出來，包括releaseUnitTestRuntimeClasspath，releaseUnitTestCompileClasspath，releaseRuntimeClasspath，releaseCompileClasspath，lintClassPath，debugUnitTestRuntimeClasspath等等，反正會列印很多很多。

這種就可以把依賴樹都列印出來。因為存在這種依賴樹的問題，所以很容易導致依賴衝突，因為你不知道別的依賴庫有沒有和另外一個依賴庫引入的依賴庫或者自己匯入的依賴庫發生了衝突。同一個依賴庫版本不同很容易導致依賴衝突。

這時候我們就需要過濾一下（window）：很多資料提示是（gradlew :app:dependencies --configuration compile，這種compile是以前的方式引入依賴，現在換成implementation）

gradlew :app:dependencies --configuration implementation

列印如下：

但不知道為啥這種不列印出來依賴樹。

接下來我又試了一下下面這個過濾條件：

gradlew :app:dependencies --configuration releaseRuntimeClasspath

這樣就可以列印出依賴樹了：

這樣對專案中的依賴就可以一目瞭然。然後ctrl + f 查詢你認為有問題有衝突的依賴。

三、使用exclude解決依賴衝突的問題

1、以下面這個例子來示範：

這個cardview是material依賴庫下的一個依賴。

這個是我在module app的MainActivity裡面正常使用。

現在假如有另外一個依賴庫中也包含了androidx.cardview這個依賴庫包的其他版本，注意是也存在的其他版本，就會可能發生衝突。衝突造成的錯誤，後面遇到再貼出來。

2、那麼我們要怎麼解除這種依賴庫引起的編譯問題呢？

//    implementation 'com.google.android.material:material:1.2.1'
    implementation('com.google.android.material:material:1.2.1') {
        exclude group: 'androidx.cardview', module: 'cardview'
    }

現在我使用gradle中的exclude的關鍵字，來排除app.gradle檔案中的這個cardview依賴庫。

解釋一下：exclude是groovy中的一個函數，group是要排除的包名，module是模組名。

用圖說更清楚：