官方依賴說明文檔參考
應(yīng)用模塊的 build.gradle 文件中包含三種不同類型的依賴項:
apply plugin: 'com.android.application'
android { ... }
dependencies {
// Dependency on a local library module
implementation project(":mylibrary")
// Dependency on local binaries
implementation fileTree(dir: 'libs', include: ['*.jar'])
//或者撵渡,您也可以按如下方式指定各個文件:
implementation files(‘libs/foo.jar’融柬,‘libs/bar.jar’)
// Dependency on a remote binary
implementation 'com.example.android:app-magic:12.3'
}
Android Studio3.0 正式版相比 2.x 的版本,Gradle版本升級為了3.x趋距,編譯速度也提高了不少粒氧。
在gadle3.0之后,默認的依賴由之前的compile更改為implementation了节腐。
先來看下2.x版本的依賴方式:
再來看看3.0的
可以看到在gradle3.0中外盯,compile依賴關(guān)系已被棄用摘盆,被implementation和api替代,provided被compile only替代饱苟,apk被runtime only替代孩擂,剩下的看名字就知道了。
我們先來看看implementation和api的區(qū)別:
api:跟2.x版本的 compile完全相同箱熬,當一個模塊包含 api 依賴項時类垦,會讓 Gradle 了解該模塊要以傳遞方式將該依賴項導(dǎo)出到其他模塊,以便這些模塊在運行時和編譯時都可以使用該依賴項城须。
implementation:當您的模塊配置 implementation 依賴項時蚤认,會讓 Gradle 了解您不希望該模塊在編譯時將該依賴項泄露給其他模塊。也就是說糕伐,其他模塊只有在運行時才能使用該依賴項砰琢。比如我在一個libiary中使用implementation依賴了gson庫,然后我的主項目依賴了libiary良瞧,那么陪汽,如果此時修改了 gson 庫的版本號,那么在重新編譯項目期間我的主項目就無法訪問gson庫中的方法褥蚯。這樣的好處是編譯速度會加快挚冤,推薦使用implementation的方式去依賴,如果你需要在編譯和運行時都提供給外部訪問遵岩,那么就使用api依賴即可你辣。
還不熟悉2.x版本依賴的可以看看下面的說明,括號里對應(yīng)的是3.0版本的依賴方式尘执。
compile(implementation,api)
這種是我們最常用的方式宴凉,使用該方式依賴的庫將會參與編譯和打包誊锭。
implementation:該依賴方式所依賴的庫不會傳遞,只會在當前module中生效弥锄。
api:該依賴方式會傳遞所依賴的庫丧靡,當其他module依賴了該module時,可以使用該module下使用api依賴的庫籽暇。
當我們依賴一些第三方的庫時温治,可能會遇到com.android.support沖突的問題,就是因為開發(fā)者使用的compile或api依賴的com.android.support包與我們本地所依賴的com.android.support包版本不一樣戒悠,所以就會報All com.android.support libraries must use the exact same version specification (mixing versions can lead to runtime crashes這個錯誤熬荆。
解決辦法參考
provided(compileOnly)
只在編譯時有效,不會參與打包绸狐。Gradle 只會將依賴項添加到編譯類路徑(也就是說卤恳,不會將其添加到構(gòu)建輸出)累盗。如果您創(chuàng)建 Android 模塊時在編譯期間需要相應(yīng)依賴項,但它在運行時可有可無突琳,此配置會很有用若债。
可以在自己的moudle中使用該方式依賴一些比如com.android.support,gson這些使用者常用的庫拆融,避免沖突蠢琳。
如果您使用此配置,那么您的庫模塊必須包含一個運行時條件镜豹,用于檢查是否提供了相應(yīng)依賴項傲须,然后適當?shù)馗淖冊撃K的行為,以使該模塊在未提供相應(yīng)依賴項的情況下仍可正常運行逛艰。這樣做不會添加不重要的瞬時依賴項躏碳,因而有助于減小最終 APK 的大小。
apk(runtimeOnly)
只在生成apk的時候參與打包散怖,編譯時不會參與菇绵,很少用。Gradle 只會將依賴項添加到構(gòu)建輸出镇眷,以便在運行時使用咬最。也就是說,不會將其添加到編譯類路徑欠动。
testCompile(testImplementation)
testCompile 只在單元測試代碼的編譯以及最終打包測試apk時有效永乌。
debugCompile(debugImplementation)
debugCompile 只在debug模式的編譯和最終的debug apk打包時有效
releaseCompile(releaseImplementation)
Release compile 僅僅針對Release 模式的編譯和最終的Release apk打包。