首頁>技術>

簡介

build.gradle是gradle中非常重要的一個檔案,因為它描述了gradle中可以執行的任務,今天本文將會帶大家體驗一下如何建立一個build.gradle檔案和如何編寫其中的內容。

project和task

gradle是一個構建工具,所謂構建工具就是透過既定的各種規則,將原始碼或者原檔案透過一定的task處理過後,打包生成目標檔案的步驟。

所以我們在gradle中有兩個非常重要的概念,分別是專案和任務。

每一個gradle的構建任務可以包含一個或者多個專案,專案可以有多種型別,比如是一個web專案或者一個java lib專案等。為了實現project要完成的目標,需要定義一個個的task來輔助完成目標。

task主要用來執行特定的任務,比如編譯class檔案,打包成jar,生成javadoc等等。

一個例子

接下來我們使用一個具體的例子來講解一下,gradle到底是怎麼用的。

首先我們建立一個新的project目錄:

$ mkdir gradle-test$ cd gradle-test

gradle提供了一個init方法,來方便的建立gradle專案的骨架,我們用下看:

gradle initStarting a Gradle Daemon (subsequent builds will be faster)Select type of project to generate:  1: basic  2: application  3: library  4: Gradle pluginEnter selection (default: basic) [1..4] 2Select implementation language:  1: C++  2: Groovy  3: Java  4: Kotlin  5: Scala  6: SwiftEnter selection (default: Java) [1..6] 3Split functionality across multiple subprojects?:  1: no - only one application project  2: yes - application and library projectsEnter selection (default: no - only one application project) [1..2] 1Select build script DSL:  1: Groovy  2: KotlinEnter selection (default: Groovy) [1..2] 1Select test framework:  1: JUnit 4  2: TestNG  3: Spock  4: JUnit JupiterEnter selection (default: JUnit 4) [1..4] 1Project name (default: gradle-test):Source package (default: gradle.test):> Task :initGet more help with your project: https://docs.gradle.org/6.7/samples/sample_building_java_applications.htmlBUILD SUCCESSFUL in 45s2 actionable tasks: 2 executed

按照你的需要,經過一系列的選擇之後,就可以生成一個基本的gradle專案了。

我們看下生成的檔案和目錄:

.├── app│   ├── build.gradle│   └── src│       ├── main│       │   ├── java│       │   │   └── gradle│       │   │       └── test│       │   │           └── App.java│       │   └── resources│       └── test│           ├── java│           │   └── gradle│           │       └── test│           │           └── AppTest.java│           └── resources├── gradle│   └── wrapper│       ├── gradle-wrapper.jar│       └── gradle-wrapper.properties├── gradlew├── gradlew.bat└── settings.gradle14 directories, 8 files

其中gradle-wrapper是幫你自動設定和安裝gradle的工具,同時它還提供了gradlew和gradlew.bat這兩個執行檔案,用來執行gradle的任務。

我們主要看其中的兩個配置檔案,settings.gradle和build.gradle。

settings.gradle中配置的是gradle中要build的專案資訊:

rootProject.name = 'gradle-test'include('app')

上面的例子中,rootProject.name指定了專案的名字,include(‘app’)表示需要引入一個叫做app的子專案,這個子專案中包含著實際的要打包的內容。

再看一下app中的build.gradle檔案:

plugins {    // Apply the application plugin to add support for building a CLI application in Java.    id 'application'}repositories {    // Use JCenter for resolving dependencies.    jcenter()}dependencies {    // Use JUnit test framework.    testImplementation 'junit:junit:4.13'    // This dependency is used by the application.    implementation 'com.google.guava:guava:29.0-jre'}application {    // Define the main class for the application.    mainClass = 'gradle.test.App'}

很簡單,指定了外掛,倉庫地址,依賴包和應用程式的main class路徑。

一切準備好之後,我們就可以進行構建和運行了。

有兩種方式來執行,一種方式就是使用系統自帶的gradle命令,一種方式就是使用剛剛gradle為你生成的gradlew。

gradle run> Configure project :appRepository {repo.url} replaced byREPOSITORY_URL .> Task :app:runHello World!
gradle build> Configure project :appRepository {repo.url} replaced byREPOSITORY_URL .BUILD SUCCESSFUL in 2s7 actionable tasks: 6 executed, 1 up-to-date

你還可以帶上 –scan 引數將build上傳到gradle scan中,得到更加詳細的構建分析:

./gradlew build --scanBUILD SUCCESSFUL in 0s7 actionable tasks: 7 executedPublishing a build scan to scans.gradle.com requires accepting the Gradle Terms of Service defined at https://gradle.com/terms-of-service.Do you accept these terms? [yes, no] yesGradle Terms of Service accepted.Publishing build scan...https://gradle.com/s/5u4w3gxeurtd2
task詳細講解

上面的例子中,我們使用的都是gradle預設的tasks,並沒有看到自定義task的使用,接下來我們將會探討一下,如何在build.gradle編寫自己的task。

這裡我們使用的groovy來編寫build.gradle,所以我們可以像執行程式碼一樣來執行它。

task指令碼

先建立一個非常簡單的task:

task hello {    doLast {        println 'Hello www.flydean.com!'    }}

上面定義了一個名叫hello的task,並且會在執行最後輸出 “Hello www.flydean.com!”。

我們這樣執行:

gradle -q helloHello www.flydean.com!

-q的意思是悄悄的執行,將會忽略gradle自身的log資訊。我們把要執行的task名字寫在gradle後面就可以了。

如果你熟悉ant命令的話,可以看到gradle的task和ant很類似,不過更加的強大。

因為是groovy指令碼,所以我們可以在其中執行程式碼:

task upper {    doLast {        String someString = 'www.flydean.com'        println "Original: someString"        println "Upper case:{someString.toUpperCase()}"    }}

執行結果:

> gradle -q upperOriginal: www.flydean.comUpper case: WWW.FLYDEAN.COM

或者執行times操作:

task count {    doLast {        4.times { print "$it " }    }}
> gradle -q count0 1 2 3
task依賴

gradle中的一個task可以依賴其他的task:

task hello {    doLast {        println 'Hello www.flydean.com!'    }}task intro {    dependsOn hello    doLast {        println "I'm flydean"    }}

上面兩個task的順序是無關的,可以依賴的寫在前面,被依賴的寫在後面,或者反過來都成立。

動態task

除了靜態的task之外,我們還可以透過程式碼來動態建立task:

4.times { counter ->    task "taskcounter" {        doLast {            println "I'm task numbercounter"        }    }}
> gradle -q task1I'm task number 1

我們還可以將task看做成為一個物件,呼叫gradle的api進行操作:

4.times { counter ->    task "taskcounter" {        doLast {            println "I'm task numbercounter"        }    }}task0.dependsOn task2, task3

上面的例子中,我們呼叫API手動建立了task之間的依賴關係:

> gradle -q task0I'm task number 2I'm task number 3I'm task number 0

還可以task之間的屬性呼叫:

task myTask {    ext.myProperty = "www.flydean.com"}task printTaskProperties {    doLast {        println myTask.myProperty    }}
預設task

如果不想每次都在呼叫gradle命令的時候手動指定某個具體的task名字,我們可以使用defaultTasks:

defaultTasks 'clean', 'run'task clean {    doLast {        println 'Default Cleaning!'    }}task run {    doLast {        println 'Default Running!'    }}task other {    doLast {        println "I'm not a default task!"    }}

上面的程式碼執行gradle和gradle clean run是相當的。

build script的外部依賴

既然build script可以用groovy程式碼來編寫,那麼如果我們想要在build script中使用外部的jar包怎麼辦呢?

這個時候,我們可以將外部依賴放到buildscript()方法中,後面的task就可以使用引入的依賴了:

import org.apache.commons.codec.binary.Base64buildscript {    repositories {        mavenCentral()    }    dependencies {        classpath group: 'commons-codec', name: 'commons-codec', version: '1.2'    }}task encode {    doLast {        def byte[] encodedString = new Base64().encode('hello world\n'.getBytes())        println new String(encodedString)    }}

上面的例子中,encode使用了一個外部的依賴包Base64,這個依賴包是在buildscript方法中引入的。

本文已收錄於 http://www.flydean.com/gradle-build-script/

最通俗的解讀,最深刻的乾貨,最簡潔的教程,眾多你不知道的小技巧等你來發現!

7
最新評論
  • BSA-TRITC(10mg/ml) TRITC-BSA 牛血清白蛋白改性標記羅丹明
  • Java,網路程式設計,TCP通訊,Wireshark抓包分析