上一節(jié):多模塊項(xiàng)目- 項(xiàng)目結(jié)構(gòu)

我們了解到一個(gè)典型的多模塊項(xiàng)目需要有一個(gè)根模塊項(xiàng)目以及模塊描述文件(默認(rèn)為settings.gradle)，下面我們將通過一個(gè) 多項(xiàng)目示例 來對多模塊項(xiàng)目的結(jié)構(gòu)以及腳本進(jìn)行更深入的了解。

如果要讓 Gradle 支持多
構(gòu)建，只需為你的項(xiàng)目確定一個(gè) 根模塊項(xiàng)目 并且在根模塊項(xiàng)目下添加 settings.gradle 文件用以描述模塊（項(xiàng)目）關(guān)系

include 'base','main'

這里將模塊（項(xiàng)目）名稱路徑的字符串以數(shù)組的形式傳遞給了include函數(shù)，Gradle 會(huì)以相對于當(dāng)前目錄按照 include 給定的模塊（項(xiàng)目）路徑查找對應(yīng)的子模塊，如果要聲明的模塊（項(xiàng)目）有多個(gè)層次可以用:進(jìn)行描述，假設(shè)main下面又分了Alpha,Bravo 那么聲明方式則按如下方式書寫

include 'base','main:Alpha','main:Bravo'

這里的 settings 文件實(shí)際上是對應(yīng)的 Settings 接口，Setitings 接口中提供的函數(shù)在本腳本中都是可用的，具體細(xì)節(jié)請查閱 >Settins接口DSL< 文檔進(jìn)行了解。

在構(gòu)建的 初始化階段，Gradle 會(huì)讀取這個(gè)文件，并創(chuàng)建一個(gè) Settings 類型的實(shí)例。Gradle 會(huì)依據(jù)此文件進(jìn)行多模塊項(xiàng)目構(gòu)建，默認(rèn)情況下 Gradle 會(huì)從同級(jí)的 master 目錄下尋找此文件，如果未找到則會(huì)去父級(jí)目錄尋找。如果搜尋不到 settings 文件，那么 Gradle 會(huì)把模塊當(dāng)做單獨(dú)構(gòu)建的項(xiàng)目去執(zhí)行單獨(dú)構(gòu)建。這里 Gradle 提供了一個(gè)命令行參數(shù) -u 或 --no-search-upward 來控制 Gradle 不去父目錄搜尋 settings 文件。

自定義初始化階段邏輯

上面已經(jīng)提到由于 Settings 文件會(huì)在 初始化階段 讀取執(zhí)行，所以我們也可以將一些需要在初始化階段執(zhí)行的邏輯放到此處，如下面的示例

include 'base','main'

println "< ---- build init ---- > "

def initFunc(){
    println "<!-- three little birds -->"
}

initFunc()

執(zhí)行Gradle build會(huì)發(fā)現(xiàn)在初始化階段已經(jīng)分別輸出了兩行語句。

< ---- build init ---- > 
<!-- three little birds -->

自定義setting文件名

默認(rèn)情況下，Gradle 會(huì)采用settings.gradle作為文件名去查找，但如果處于某種不可描述的原因要采用其它名稱的話也是可以的，調(diào)用命令時(shí)可以通過-c或者--settings-file參數(shù)來指定settings文件的位置以及名稱。

tip: 通常情況下，不存在孤立的子模塊，所以構(gòu)建的執(zhí)行順序往往是由依賴順序所決定的。但如果無法通過依賴順序決定，那么 Gradle 會(huì)簡單的按照首字母順序決定構(gòu)建順序。下一節(jié)多模塊項(xiàng)目- build文件