#ThoughtWorkers好声音# 第十五期 关于 Gradle ,我们常常会想到的是如何编写一个 Task ,怎么写一个 Plugin ,但是对于 Gradle 命令行本身怎么用却探究不多。 还好成都办公室的黄博文注意到了这个让人遗忘的角落,写了一篇文章,揭秘鲜为人知的《Gradle命令行黑魔法》
毫无疑问,现在Gradle已经成为java世界最火的构建工具,风头已经盖过了冗余的ant,落后的maven。Gradle是以Groovy语言编写的一套构建脚本的DSL,由于Groovy语法的优雅,所以导致Gradle天生就有简洁、可读性强、灵活等特性。
Gradle的命令行功能也非常强大。本人从maven转到Gradle,深深被gradle强大的命令行功能折服。通过命令行来实现Gradle的各种特性,就像魔法师在表演魔法一样。
-q
(或--quiet
)是启用重要信息级别,该级别下只会输出自己在命令行下打印的信息及错误信息。
-i
(或--info
)则会输出除debug以外的所有信息。
-d
(或--debug
)会输出所有日志信息。
比如一个build.gradle有这样一个task。
taskhello<<{
println'hello world!'
}
加入-q
与不加-q
的输出结果不同。
$ gradle hello
:hello
hello world!
BUILD SUCCESSFUL
Total time: 3.546 secs
$ gradle -q hello
hello world!
-s
(或--stacktrace
)来输出详细的错误堆栈。你还可以使用-S
(或--full-stacktrace
)来输出全部堆栈信息,不过一般不推荐这样做,因为gradle是基于groovy语言,而groovy作为一门动态语言可能会输出与你的错误代码毫不相关的信息。-x
命令。$ 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
--continue
命令。使用--continue
命令后即使遇到某些task失败也不会停止后续task的执行。但是需要注意的是如果某个task失败了,那么依赖于这个task的其他task依旧不会执行,因为这会带来不安全的因素。taskhelloWorld<<{
println'hello world!'
}
比如调用helloWorld可以通过全名调用、前缀调用或首字母调用。
$ gradle -q helloWorld
hello world!
$ gradle -q hell
hello world!
$ gradle -q hW
hello world!
-b
命令。 比如当前目录有个子目录subproject1,里面有个叫hello.gradle。taskhelloWorld<<{
println'hello world!'
}
那么在当前目录可以使用以下命令调用这个task。
$ gradle -b subproject1/hello.gradle helloWorld
:helloWorld
hello world!
BUILD SUCCESSFUL
Total time: 3.752 secs
-p
来指定使用的项目。gradle-q-plearnGradlehelloWorld
这条命令是调用learnGradle这个项目下的helloWorld task。
gradle tasks
可以列出当前所有可被使用的task,但是并没有显示task之间的依赖关系。我们可以加上--all
来显示 task的依赖关系。$ gradle tasks --all
………………
Other tasks
-----------
task0
task1
task2
task3
…………
从上面可以看出task0依赖task1、task2及task3。
gradle dependencies
可以查看项目中包的依赖关系。不过是列出了所有阶段的依赖,如果项目中依赖复杂的话看起来有点头痛。那么可以使用--configuration
来查看指定阶段的依赖情况。使用gradle -q dependencies --configuration testCompile
可以只查看testComiple的依赖。
查看指定dependency的依赖情况。 假如我想查看项目中有没有引入junit,那些阶段引入了junit,那么可以使用dependecyInsight
来查看。
注意dependencyInsight
默认只会查看compile阶段的依赖,如果要查看其他阶段可以使用--configuration
来指定。
--profile
命令行可以产生build运行时间的报告。该报告存储在build/report/profile目录,名称为build运行的时间。然后在build/report/profile目录下可以看到build的report。
这个报表非常有用,尤其是在在缩短build时间时可以快速定位那些耗时长的task。
-m
来试运行。这样我们可以一目了然的看到那些task被执行了,又不需要花太多的时间。
其实Gradle自带一个图形界面来让习惯gui操作的人来操作Gradle。打开方式很简单。
$ gradle --gui
这样就会弹出一个gui界面。
通过这个gui界面可以很方面的执行gradle的各种命令,还可以将常用的命令保存为favorites。该gui的配置信息默认被存储在当前项目的gradle-app.setting文件中。
注意使用gradle --gui
会阻塞当前终端,可以使用gradle --gui&
来实现后台运行。
--recompile-scripts
来强行重新编译。