兩個(gè)重要概念
項(xiàng)目(Project)通常代表的是構(gòu)建內(nèi)容跌宛。Gradle 構(gòu)建就是由一個(gè)或多個(gè)項(xiàng)目組成的。
任務(wù)(Task)是在構(gòu)建階段被執(zhí)行的操作,是 Gradle 構(gòu)建的原子工作單位,在項(xiàng)目的構(gòu)建腳本中定義坤检,并且可以彼此依賴。
每個(gè)項(xiàng)目的編譯至少有一個(gè) Project期吓,每個(gè) Project 里面包含了多個(gè) Task早歇,Task 里面又包含很多 Action 代碼塊,里面包含了需要被執(zhí)行的代碼讨勤。
生命周期
初始化階段:初始化階段的任務(wù)是創(chuàng)建項(xiàng)目的層次結(jié)構(gòu)缺前,并且為每一個(gè)項(xiàng)目創(chuàng)建一個(gè)Project實(shí)例。
與初始化階段相關(guān)的腳本文件是settings.gradle(包括<USER_HOME>/.gradle/init.d目錄下的所有.gradle腳本文件悬襟,這些文件作用于本機(jī)的所有構(gòu)建過程)衅码。
配置階段:配置階段的任務(wù)是執(zhí)行各項(xiàng)目下的build.gradle腳本,完成Project的配置脊岳,并且構(gòu)造Task任務(wù)依賴關(guān)系圖以便在執(zhí)行階段按照依賴關(guān)系執(zhí)行Task逝段。
每個(gè)build.gralde腳本文件對應(yīng)一個(gè)Project對象,在初始化階段創(chuàng)建割捅。配置階段執(zhí)行的代碼包括build.gralde中的各種語句奶躯、閉包以及Task中的配置段語句。
在配置階段結(jié)束后亿驾,Gradle會(huì)根據(jù)任務(wù)Task的依賴關(guān)系創(chuàng)建一個(gè)有向無環(huán)圖嘹黔。
執(zhí)行階段:通過Gradle對象的getTaskGraph方法訪問,對應(yīng)的類為TaskExecutionGraph莫瞬,然后通過調(diào)用gradle <任務(wù)名>執(zhí)行對應(yīng)任務(wù)儡蔓。
生命周期監(jiān)聽方法執(zhí)行順序:
方法 | 說明 |
---|---|
gradle.settingsEvaluated | 當(dāng) settings.gradle 加載并配置完畢后執(zhí)行閉包回調(diào),setting對象已經(jīng)配置好并且準(zhǔn)備開始加載構(gòu)建 project疼邀。這個(gè)回調(diào)在 build.gradle 中聲明也是不起作用的喂江,在 settings.gradle 中聲明是可以的。 |
gradle.projectsLoaded | 當(dāng) setting 中的所有project 都創(chuàng)建好時(shí)執(zhí)行閉包回調(diào)旁振。gradle 對象會(huì)作為參數(shù)傳遞給閉包获询。如果將這個(gè)聲明周期掛接閉包聲明在 build.gradle 文件中涨岁,那么將不會(huì)發(fā)生這個(gè)事件,因?yàn)轫?xiàng)目創(chuàng)建發(fā)生在初始化階段吉嚣。放在 settings.gradle 中是可以執(zhí)行的梢薪。 |
gradle.beforeProject | project 配置前執(zhí)行的閉包或者回調(diào)方法,當(dāng)前 project 作為參數(shù)傳遞給閉包尝哆。 |
project.beforeEvaluate | 在 project 開始配置前調(diào)用秉撇,當(dāng)前的 project 作為參數(shù)傳遞給閉包。 |
gradle.afterProject | project 配置完畢后立即執(zhí)行的閉包或者回調(diào)方法较解。在配置參數(shù)失敗后會(huì)傳入兩個(gè)參數(shù)畜疾,前者是當(dāng)前 project赴邻,后者顯示失敗信息印衔。 |
project.afterEvaluate | 只要 project 配置成功均會(huì)調(diào)用,不論是在父模塊還是子模塊姥敛。 |
gradle.projectsEvaluated | 所有的 project 都配置完成后的回調(diào)奸焙,此時(shí),所有的project都已經(jīng)配置完畢彤敛,準(zhǔn)備開始生成 task 圖与帆。gradle 對象會(huì)作為參數(shù)傳遞給閉包。 |
gradle.taskGraph.graphPopulated | addTaskExecutionGraphListener 添加 task 執(zhí)行圖的監(jiān)聽器墨榄,當(dāng)執(zhí)行圖配置好會(huì)執(zhí)行通知玄糟。 |
gradle.taskGraph.whenReady | 設(shè)置一個(gè) task 執(zhí)行圖準(zhǔn)備好后的閉包或者回調(diào)方法。該 taskGrahp 作為參數(shù)傳遞給閉包袄秩。 |
gradle.buildFinished | 構(gòu)建結(jié)束時(shí)的回調(diào)阵翎,此時(shí)所有的任務(wù)都已經(jīng)執(zhí)行,一個(gè)構(gòu)建結(jié)果的對象 BuildResult 作為參數(shù)傳遞給閉包之剧。 |
自定義任務(wù)(Task)
Gradle支持兩種類型的任務(wù):
簡單任務(wù):是 DefaultTask 的一個(gè)實(shí)例郭卫,本身不具備任何功能,需在任務(wù)中添加代碼背稼。
增強(qiáng)任務(wù):本身具備可在腳本中配置的功能(例如 Copy 任務(wù))贰军。
在腳本中定義task:
task customTask() {
println 'customTask'
doFirst {
println 'doFirst'
}
doLast {
println 'doLast'
}
}
在配置階段,會(huì)輸出 customTask 蟹肘;在執(zhí)行階段會(huì)輸出 doFirst doLast词疼。
繼承DefaultTask:
class CustomTask extends DefaultTask {
}