前言
本文屬于 《一款基于MVP架構(gòu)的快速應用開發(fā)框架,kotlin版本》(注:此文章還在更新中,可先看看又厉,敬請期待!) 的擴展文章椎瘟,詳細介紹在使用 LeoFastDevMvpKotlin 快速開發(fā)框架的時候覆致,進行項目依賴管理的方法。
介紹
Android 依賴統(tǒng)一管理距目前為止降传,博主一共知道有三種方法篷朵,分別是:
- 傳統(tǒng)apply from的方式(也是本文想講的一種方式):新建一個 「config.gradle」 文件,然后將項目中所有依賴寫在里面婆排,更新只需修改 「config.gradle」 文件內(nèi)容声旺,作用于所有module。
- buildSrc 方式:當運行 Gradle 時會檢查項目中是否存在一個名為 buildSrc 的目錄段只。然后 Gradle 會自動編譯并測試這段代碼腮猖,并將其放入構(gòu)建腳本的類路徑中, 對于多項目構(gòu)建,只能有一個 buildSrc 目錄赞枕,該目錄必須位于根項目目錄中, buildSrc 是 Gradle 項目根目錄下的一個目錄澈缺。
- Composing builds 方式:復合構(gòu)建只是包含其他構(gòu)建的構(gòu)建. 在許多方面,復合構(gòu)建類似于 Gradle 多項目構(gòu)建炕婶,不同之處在于姐赡,它包括完整的 builds ,而不是包含單個 projects柠掂,總的來說项滑,他有 buildSrc 方式的優(yōu)點,同時更新不需要重新構(gòu)建整個項目涯贞。
三種方式各有各的好枪狂,目前最完美的應該是第三種實現(xiàn)危喉。但是這種方式不利于框架使用,因為它屬于的是新建一個module州疾,如果項目遠程依賴了框架辜限,默認也包含了這個 module。所以博主選擇了第一種方式严蓖。以下文章也是圍繞第一種方式進行講解薄嫡。
實現(xiàn)方式
實現(xiàn)這個統(tǒng)一依賴管理,攏共分三步谈飒,分別是:
- 第一步:創(chuàng)建「config.gradle」 文件
- 第二步:項目當中引入「config.gradle」
- 第三步:在所有module的「build.gradle」當中添加依賴
-
第一步:創(chuàng)建 「config.gradle」 文件
首先將 Aandroid Studio 目錄的Android格式修改為Project岂座,然后再創(chuàng)建一個「config.gradle」的文件
然后我們編輯文章里面的內(nèi)容,這里直接給出框架的代碼出來(篇幅太長杭措,省略部分代碼):
ext { /** * 基礎(chǔ)配置 對應 build.gradle 當中 android 括號里面的值 */ android = [ compileSdk : 32, minSdk : 21, targetSdk : 32, versionCode : 1, versionName : "1.0.0", testInstrumentationRunner: "androidx.test.runner.AndroidJUnitRunner", consumerProguardFiles : "consumer-rules.pro" ...... ] /** * 版本號 包含每一個依賴的版本號费什,僅僅作用于下面的 dependencies */ version = [ coreKtx : "1.7.0", appcompat : "1.6.1", material : "1.8.0", constraintLayout : "2.1.3", navigationFragmentKtx: "2.3.5", navigationUiKtx : "2.3.5", junit : "4.13.2", testJunit : "1.1.5", espresso : "3.4.0", ...... ] /** * 項目依賴 可根據(jù)項目增加刪除,但是可不刪除本文件里的手素,在 build.gradle 不寫依賴即可 * 因為MVP框架默認依賴的也在次文件中鸳址,建議只添加,不要刪除 */ dependencies = [ coreKtx : "androidx.core:core-ktx:$version.coreKtx", appcompat : "androidx.appcompat:appcompat:$version.appcompat", material : "com.google.android.material:material:$version.material", constraintLayout : "androidx.constraintlayout:constraintlayout:$version.constraintLayout", navigationFragmentKtx : "androidx.navigation:navigation-fragment-ktx:$version.navigationFragmentKtx", navigationUiKtx : "androidx.navigation:navigation-ui-ktx:$version.navigationUiKtx", junit : "junit:junit:$version.junit", testJunit : "androidx.test.ext:junit:$version.testJunit", espresso : "androidx.test.espresso:espresso-core:$version.espresso", ...... ] }
簡單理解就是將所有的依賴泉懦,分成版本號以及依賴名兩個數(shù)組的方式保存稿黍,所有都在這個文件統(tǒng)一管管理。用 ext 包裹三個數(shù)組:第一個是「build.gradle」Android 里面的崩哩,第二個是版本號巡球,第三個是依賴的名字。依賴名字數(shù)組里面的依賴版本號通過 $ 關(guān)鍵字指代 version 數(shù)組里面的版本號
-
第二步:項目當中引入 「config.gradle」
將「config.gradle」文件引入項目當中邓嘹,在項目的根目錄的「build.gradle」文件(也就是剛剛新建的 「config.gradle」同目錄下的),添加如下代碼:
apply from:"config.gradle"
需要注意的的是酣栈,如果你是 AndroidStudio 4.0+ 那么你將看到這樣的「build.gradle」文件
// Top-level build file where you can add configuration options common to all sub-projects/modules. plugins { id 'com.android.application' version '7.2.2' apply false id 'com.android.library' version '7.2.2' apply false id 'org.jetbrains.kotlin.android' version '1.7.10' apply false } apply from:"config.gradle"
相反,如果你是 AndroidStudio 4.0- 那么你將會看到這樣的「build.gradle」文件
apply from: "config.gradle" buildscript { ext.kotlin_version="1.7.10" repositories { maven { url "https://jitpack.io" } mavenCentral() google() } dependencies { classpath "com.android.tools.build:gradle:4.2.1" classpath 'com.jakewharton:butterknife-gradle-plugin:10.2.3' classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version" // NOTE: Do not place your application dependencies here; they belong // in the individual module build.gradle files } } allprojects { repositories { maven { url "https://jitpack.io" } mavenCentral() google() } } task clean(type: Delete) { delete rootProject.buildDir }
不過僅僅是兩個文件里面的內(nèi)容不一致汹押,這個文件的位置是一樣的矿筝,而且我們添加的引入代碼也是一樣的∨锛郑可以說窖维,這只是順帶提一嘴,實際上不影響我們實現(xiàn)統(tǒng)一依賴管理這個方式妙痹。
-
第三步:在所有module的「build.gradle」當中添加依賴
這一步是最重要的铸史,我們完成了上面兩步之后,只是做好了準備怯伊,現(xiàn)在我們需要將我們每一個module里面「build.gradle」文件里面的依賴指向「config.gradle」文件沛贪。也就是下圖圈起來的 那兩個「build.gradle」文件。
因為我們第二步的時候已經(jīng)在根目錄引入了「config.gradle」,所以我們在「build.gradle」就可以指向「config.gradle」例如:
implementation rootProject.ext.dependencies.coreKtx
這一行,就指代了我們「config.gradle」文件里面的 dependencies 數(shù)組里面的 coreKtx 的內(nèi)容利赋。完整示例如下:
plugins { id 'com.android.application' id 'org.jetbrains.kotlin.android' } android { namespace 'leo.dev.mvp.kt' // compileSdk 32 compileSdk rootProject.ext.android.compileSdk defaultConfig { applicationId "leo.dev.mvp.kt" // minSdk 21 // targetSdk 32 // versionCode 1 // versionName "1.0" // // testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner" minSdk rootProject.ext.android.minSdk targetSdk rootProject.ext.android.targetSdk versionCode rootProject.ext.android.versionCode versionName rootProject.ext.android.versionName testInstrumentationRunner rootProject.ext.android.testInstrumentationRunner } ...... } dependencies { implementation fileTree(include: ['*.jar'], dir: 'libs') // implementation 'androidx.core:core-ktx:1.7.0' // implementation 'androidx.appcompat:appcompat:1.6.1' // implementation // // testImplementation 'junit:junit:4.13.2' // androidTestImplementation 'androidx.test.ext:junit:1.1.5' // androidTestImplementation 'androidx.test.espresso:espresso-core:3.5.1' implementation rootProject.ext.dependencies.coreKtx implementation rootProject.ext.dependencies.appcompat implementation rootProject.ext.dependencies.material testImplementation rootProject.ext.dependencies.junit androidTestImplementation rootProject.ext.dependencies.testJunit androidTestImplementation rootProject.ext.dependencies.espresso }
需要注意的是,我們在編寫代碼的時候猩系,是沒有代碼自動補全的媚送。所以得小心翼翼,必須要和「config.gradle」文件里面的名字向一致寇甸。
注意事項
- 首先就是這種方式在coding的時候塘偎,是沒有代碼補全的(只有輸入過的,才會有提示)拿霉,我們需要確保我們的名字一致
- 我們在增加依賴的時候吟秩,在「config.gradle」里面添加完之后,記得在對應的module里面的「build.gradle」里面添加對應的指向代碼绽淘。
總結(jié)
以上就是本篇文章的全部內(nèi)容涵防,總結(jié)起來其實步驟不多,也就三步沪铭。但是需要注意的是細節(jié)壮池。需要保持寫入的依賴與「config.gradle」文件一致,并且未寫過的詞杀怠,是不會有代碼自動補全的椰憋。
另外本篇文章是本文屬于 《一款基于MVP架構(gòu)的快速應用開發(fā)框架,kotlin版本》 的擴展文章赔退,所以會一步一步說得比較詳細一點橙依。大家可以挑重點跳過閱讀。