Gradle项目中gradle.build文件中的buildScript代码块
感謝原作者的勞動
在編寫Gradle腳本的時候,在build.gradle文件中經(jīng)常看到這樣的代碼:
這樣子很容易讓人奇怪,為什么repositories要聲明兩次哪?buildscript代碼塊中的聲明與下半部分聲明有什么不同?
其實答案非常簡單。buildscript中的聲明是gradle腳本自身需要使用的資源。可以聲明的資源包括依賴項、第三方插件、maven倉庫地址等。而在build.gradle文件中直接聲明的依賴項、倉庫地址等信息是項目自身需要的資源。
gradle是由groovy語言編寫的,支持groovy語法,可以靈活的使用已有的各種ant插件、基于jvm的類庫,這也是它比maven、ant等構(gòu)建腳本強大的原因。雖然gradle支持開箱即用,但是如果你想在腳本中使用一些第三方的插件、類庫等,就需要自己手動添加對這些插件、類庫的引用。而這些插件、類庫又不是直接服務(wù)于項目的,而是支持其它build腳本的運行。所以你應(yīng)當(dāng)將這部分的引用放置在buildscript代碼塊中。gradle在執(zhí)行腳本時,會優(yōu)先執(zhí)行buildscript代碼塊中的內(nèi)容,然后才會執(zhí)行剩余的build腳本。
舉個例子,假設(shè)我們要編寫一個task,用于解析csv文件并輸出其內(nèi)容。雖然我們可以使用gradle編寫解析csv文件的代碼,但其實apache有個庫已經(jīng)實現(xiàn)了一個解析csv文件的庫供我們直接使用。我們?nèi)绻胍褂眠@個庫,需要在gradle.build文件中加入對該庫的引用。
buildscript {repositories {mavenLocal()mavenCentral()}dependencies {classpath 'org.apache.commons:commons-csv:1.0'} }import org.apache.commons.csv.*task printCSV() {doLast {def records = CSVFormat.EXCEL.parse(new FileReader('config/sample.csv'))for (item in records) {print item.get(0) + ' 'println item.get(1)}} }buildscript代碼塊中的repositories和dependencies的使用方式與直接在build.gradle文件中的使用方式幾乎完全一樣。唯一不同之處是在buildscript代碼塊中你可以對dependencies使用classpath聲明。該classpath聲明說明了在執(zhí)行其余的build腳本時,class loader可以使用這些你提供的依賴項。這也正是我們使用buildscript代碼塊的目的。
而如果你的項目中需要使用該類庫的話,就需要定義在buildscript代碼塊之外的dependencies代碼塊中。所以有可能會看到在build.gradle中出現(xiàn)以下代碼:
repositories {mavenLocal()mavenCentral() }dependencies {compile 'org.springframework.ws:spring-ws-core:2.2.0.RELEASE','org.apache.commons:commons-csv:1.0' }buildscript {repositories {mavenLocal()mavenCentral()}dependencies {classpath 'org.apache.commons:commons-csv:1.0'} }import org.apache.commons.csv.*task printCSV() {doLast {def records = CSVFormat.EXCEL.parse(new FileReader('config/sample.csv'))for (item in records) {print item.get(0) + ' 'println item.get(1)}} }官方具體解釋請參見:
http://chimera.labs.oreilly.com/books/1234000001741/ch04.html#_buildscript_dependencies
出處:http://www.cnblogs.com/huang0925
總結(jié)
以上是生活随笔為你收集整理的Gradle项目中gradle.build文件中的buildScript代码块的全部內(nèi)容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: gradle中的JCenter与mave
- 下一篇: gradle插件用户指南(翻译)