上一節(jié):多模塊項(xiàng)目- 項(xiàng)目結(jié)構(gòu)
我們了解到一個(gè)典型的多模塊項(xiàng)目需要有一個(gè)根模塊項(xiàng)目以及模塊描述文件(默認(rèn)為settings.gradle)，下面我們將通過一個(gè) 多項(xiàng)目示例 來對(duì)多模塊項(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ì)以相對(duì)于當(dāng)前目錄按照 include 給定的模塊（項(xiàng)目）路徑查找對(duì)應(yīng)的子模塊甸赃，如果要聲明的模塊（項(xiàng)目）有多個(gè)層次可以用:進(jìn)行描述宦赠，假設(shè)main下面又分了Alpha,Bravo 那么聲明方式則按如下方式書寫
include 'base','main:Alpha','main:Bravo'
這里的 settings 文件實(shí)際上是對(duì)應(yīng)的 Settings 接口骤坐，Setitings 接口中提供的函數(shù)在本腳本中都是可用的锻拘，具體細(xì)節(jié)請(qǐng)查閱 >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ì)簡(jiǎn)單的按照首字母順序決定構(gòu)建順序衩辟。下一節(jié)多模塊項(xiàng)目- build文件
