文章出處

毫無疑問，現在Gradle已經成為java世界最火的構建工具，風頭已經蓋過了冗余的ant，落后的maven。Gradle是以Groovy語言編寫的一套構建腳本的DSL，由于Groovy語法的優雅，所以導致Gradle天生就有簡潔、可讀性強、靈活等特性。

Gradle的命令行功能也非常強大。本人從maven轉到Gradle，深深被gradle強大的命令行功能折服。通過命令行來實現Gradle的各種特性，就像魔法師在表演魔法一樣。

  • 日志輸出。 Gradle中的日期有6個層級。從高到低分別是 ERROR（錯誤信息）、QUIET（重要信息）、WARNGING（警告信息）、LIFECYCLE（進程信息）、INFO（一般信息）、DEBUG（調試信息）。在執行gradle task時可以適時的調整信息輸出等級，以便更方便的觀看執行結果。

    比如一個build.gradle有這樣一個task

1
2
3

task hello << {
     println 'hello world!'
}

加入-q與不加-q的輸出結果不同。

1
2
3
4
5
6
7
8
9

$ gradle hello
:hello
hello world!

BUILD SUCCESSFUL

Total time: 3.546 secs
$ gradle -q hello
hello world!

  • 堆棧跟蹤。如果執行gradle task失敗時，如果想得到更詳細的錯誤信息，那么就可以使用-s(或--stacktrace)來輸出詳細的錯誤堆棧。你還可以使用-S(或--full-stacktrace)來輸出全部堆棧信息，不過一般不推薦這樣做，因為gradle是基于groovy語言，而groovy作為一門動態語言可能會輸出與你的錯誤代碼毫不相關的信息。

  • 跳過指定的測試。如果你在執行build的時候想跳過test task，那么可以使用-x命令。

1
2
3
4
5
6
7
8
9
10
11
12

$ gradle build -x test
:compileJava UP-TO-DATE
:processResources UP-TO-DATE
:classes UP-TO-DATE
:jar UP-TO-DATE
:assemble UP-TO-DATE
:check
:build

BUILD SUCCESSFUL

Total time: 3.529 secs

  • 繼續執行task而忽略前面失敗的task。默認情況下，如果有某個task失敗，后續的task就不會繼續執行。但是有時候我們想運行所有的task來一次性得到所有的構建錯誤，那么我們可以使用--continue命令。使用--continue命令后即使遇到某些task失敗也不會停止后續task的執行。但是需要注意的是如果某個task失敗了，那么依賴于這個task的其他task依舊不會執行，因為這會帶來不安全的因素。

  • 調用task時使用短名或縮寫。如果一個task的名稱過程，那么調用時可以只輸入部分名稱即可調用，無需輸入全名。

1
2
3

task helloWorld << {
     println 'hello world!'
}

比如調用helloWorld可以通過全名調用、前綴調用或首字母調用。

1
2
3
4
5
6

$ gradle -q helloWorld
hello world!
$ gradle -q hell
hello world!
$ gradle -q hW
hello world!
  • 使用指定的gradle文件調用task。默認情況下，如果你調用gradle task，那么首先會尋找當前目錄下的build.gradle文件,以及根據settings.gradle中的配置尋找子項目的build.gradle。但是有時候我們想指定使用某個gradle文件，那么可以使用-b命令。 比如當前目錄有個子目錄subproject1,里面有個叫hello.gradle。
subproject1/hello.gradle
1
2
3

task helloWorld << {
     println 'hello world!'
}

那么在當前目錄可以使用以下命令調用這個task。

1
2
3
4
5
6
7

$ gradle -b subproject1/hello.gradle  helloWorld
:helloWorld
hello world!

BUILD SUCCESSFUL

Total time: 3.752 secs
  • 使用指定的項目目錄調用task。前面已經說過，執行gradle的task默認會在當前目錄尋找build.gradle及settings.gradle文件。如果我們想在任何地方執行某個項目的task，那么可以使用-p來指定使用的項目。
1

gradle -q -b learnGradle helloWorld

這條命令是調用learnGradle這個項目下的helloWorld task。

  • 顯示task之間的依賴關系。眾所周知，使用gradle tasks可以列出當前所有可被使用的task，但是并沒有顯示task之間的依賴關系。我們可以加上--all來顯示 task的依賴關系。
1
2
3
4
5
6
7
8
9
10
11

$ gradle tasks --all
………………

Other tasks
-----------
task0
    task1
    task2
    task3

…………

從上面可以看出task0依賴task1、task2及task3。
  • 查看指定階段的依賴關系。使用gradle dependencies 可以查看項目中包的依賴關系。不過是列出了所有階段的依賴，如果項目中依賴復雜的話看起來有點頭痛。那么可以使用--configuration來查看指定階段的依賴情況。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25

$ gradle -q dependencies

------------------------------------------------------------
Root project
------------------------------------------------------------

archives - Configuration for archive artifacts.
No dependencies

compile - Compile classpath for source set 'main'.
No dependencies

default - Configuration for default artifacts.
No dependencies

runtime - Runtime classpath for source set 'main'.
No dependencies

testCompile - Compile classpath for source set 'test'.
\--- junit:junit:4.11
     \--- org.hamcrest:hamcrest-core:1.3

testRuntime - Runtime classpath for source set 'test'.
\--- junit:junit:4.11
     \--- org.hamcrest:hamcrest-core:1.3

使用gradle -q dependencies --configuration testCompile可以只查看testComiple的依賴。

1
2
3
4
5
6
7
8
9

$ gradle -q dependencies --configuration testCompile

------------------------------------------------------------
Root project
------------------------------------------------------------

testCompile - Compile classpath for source set 'test'.
\--- junit:junit:4.11
     \--- org.hamcrest:hamcrest-core:1.3
  • 查看指定dependency的依賴情況。 假如我想查看項目中有沒有引入junit，那些階段引入了junit，那么可以使用dependecyInsight來查看。
1
2
3
4

$ gradle dependencyInsight --dependency junit --configuration testCompile
:dependencyInsight
junit:junit:4.11
\--- testCompile

注意dependencyInsight默認只會查看compile階段的依賴，如果要查看其他階段可以使用--configuration來指定。

  • 使用--profile命令行可以產生build運行時間的報告。該報告存儲在build/report/profile目錄，名稱為build運行的時間。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

$ gradle build --profile
:compileJava UP-TO-DATE
:processResources UP-TO-DATE
:classes UP-TO-DATE
:jar UP-TO-DATE
:assemble UP-TO-DATE
:compileTestJava UP-TO-DATE
:processTestResources UP-TO-DATE
:testClasses UP-TO-DATE
:test UP-TO-DATE
:check UP-TO-DATE
:build UP-TO-DATE

BUILD SUCCESSFUL

Total time: 3.726 secs

然后在build/report/profile目錄下可以看到build的report。

這個報表非常有用，尤其是在在縮短build時間時可以快速定位那些耗時長的task。

  • 試運行build。如果你想知道某個task執行時那些task會被一起執行，但是你又不想真正的執行這些task，可以使用-m來試運行。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

$ gradle -m build
:compileJava SKIPPED
:processResources SKIPPED
:classes SKIPPED
:jar SKIPPED
:assemble SKIPPED
:compileTestJava SKIPPED
:processTestResources SKIPPED
:testClasses SKIPPED
:test SKIPPED
:check SKIPPED
:build SKIPPED

BUILD SUCCESSFUL

Total time: 3.53 secs

這樣我們可以一目了然的看到那些task被執行了，又不需要花太多的時間。

  • Gradle的圖形界面。

其實Gradle自帶一個圖形界面來讓習慣gui操作的人來操作Gradle。打開方式很簡單。

1

$ gradle --gui

這樣就會彈出一個gui界面。

通過這個gui界面可以很方面的執行gradle的各種命令，還可以將常用的命令保存為favorites。該gui的配置信息默認被存儲在當前項目的gradle-app.setting文件中。

注意使用gradle --gui會阻塞當前終端，可以使用gradle --gui&來實現后臺運行。

  • 重新編譯Gradle腳本。第一次運行Gradle命令，會在項目更目錄下生成一個.gradle目錄來存放編譯后的腳本。只有當構建腳本發生修改時采用重新編譯。我們可以使用--recompile-scripts來強行重新編譯。

文章列表


不含病毒。www.avast.com
arrow
arrow
    全站熱搜
    創作者介紹
    創作者 大師兄 的頭像
    大師兄

    IT工程師數位筆記本

    大師兄 發表在 痞客邦 留言(0) 人氣()

    E-mail轉寄