我们先来学习一下gradle简单的脚本。
构建第一个脚本
projects 和 tasks是 Gradle 中最重要的两个概念。任何一个 Gradle 构建都是由一个或多个 projects 组成。每个 project 包括许多可构建组成部分。 这完全取决于你要构建些什么。举个例子,每个 project 或许是一个 jar 包或者一个 web 应用,它也可以是一个由许多其他项目中产生的 jar 构成的 zip 压缩包。一个 project 不必描述它只能进行构建操作。它也可以部署你的应用或搭建你的环境。不要担心它像听上去的那样庞大。 Gradle 的 build-by-convention 可以让您来具体定义一个 project 到底该做什么。每个 project 都由多个 tasks 组成。每个 task 都代表了构建执行过程中的一个原子性操作。如编译,打包,生成 javadoc,发布到某个仓库等操作。到目前为止,可以发现我们可以在一个 project 中定义一些简单任务。
类似于Maven的pom.xml文件,每个Gradle项目都需要有一个对应的配置文件,就叫build.gradle文件,当在命令中执行gradle命令时,Gradle会去寻找名字为build.gradle的文件,如果找不到,就会显示帮助信息。比如我们新建一个空文件夹hello,并在里面执行一条类似maven的清理命令 :
gradle clean
我们来在hello文件夹中创建一个build.gradle文件,在文件中定义一个独立的任务,在gradle中叫做task,也就是任务。在本例子中我们给任务起名为hello,任务要打印出经典的Hello World,完成这些需要使用Gradle的通用语言Groovy,将println命令添加到task任务的 doLast中,具体的任务脚本十分简单,如下:
然后在命令行中运行该task:
gradle -q hello
使用Gradle打印字符串就是这么简单!-q 参数的作用是,该参数用来控制 gradle 的日志级别,可以保证只输出我们需要的内容。不加输出的内容就是:
上面的脚本定义了一个叫做 hello 的 task,并且给它添加了一个动作。当执行 gradle hello 的时候, Gralde 便会去调用 hello 这个任务来执行给定操作。这些操作其实就是一个用 groovy 书写的闭包。如果你觉得它看上去跟 Ant 中的 targets 很像,那么是对的。Gradle 的 tasks 就相当于 Ant 中的 targets。不过你会发现他功能更加强大。
下面用一种更简洁的方式来定义上面的 hello 任务:
上面的脚本又一次采用闭包的方式来定义了一个叫做 hello 的任务,我们将会更多的采用这种简单的风格来定义任务。查看运行效果:
再来看一下gradle对ant任务的使用:
来运行看一下效果:
gradle对ant有很好的集成,因为gradle使用的是Groovy,我们可以单独定义一个方法调用:
可以看到,效果是一样的:
我们再来定义一个任务:
gradle执行哪个就会打印哪个,另一个不会打印:
我们来让一个task依赖于另一个task,需要使用dependsOn关键字:
这样就可以每次运行rock任务就自动先运行helloant任务,来看一下效果:
一个任务可以多次执行,这种情况需要定义动态task,脚本可以在循环中使用Groovy在java.lang.Number中扩展的times方法创建3个新的task,Groovy自动暴露一个隐式的变量it来指定循环迭代的次数,使用这个计数器构建task的名字,对于第一轮迭代,task可以叫rock0,以此类推。动态定义如下:
我们看到把rock改成了动态定义,外面使用了times定义了3次,里面使用了双引号(必须)括起来后面加上了$it,表示rock0,rock1,rock2等,后面的依赖依照顺序依次依赖,我们来执行一个rock1看一下:
可以看到把rock1和前面所有传递的依赖都执行了一遍。rock2是最后一个任务,我们来定义一个空任务,依赖rock2,这样执行空任务就能执行所有的任务:
注意空任务start中的冒号必须写上,来执行看看效果:
这就是task简单的定义和使用!
查看所有Task
上面的例子展示了如何使用gradle指定运行一个task,要运行一个task就需要知道它的名字,来看gradle自带的一个任务,帮助我们查询所有可用的task:
gradle tasks
可以看到列出的信息不是很全,很多是说明性质的,为了看到所有的task,我们需要在后面加上--all:
gradle tasks --all
我们看到了所有的task,包括我们自己定义的。
gradle提供了任务组的概念,可以看做是多个task的集群,每个构建脚本都会暴露help tasks任务组(如上图),如果某个task不属于任何一个任务组,他就会显示在other tasks中。
排除一个任务
我们在执行task的时候,可以指定排除一个任务,比如我们排除任务rock0:
gradle start -x rock0
可以看到只执行了rock1,rock2和start三个任务,rock0和helloant没有执行。gradle会排除指定任务和指定任务的依赖任务,这个概念叫做智能排除。
构建参数
我们执行gradle命令可以控制日志级别,比如想打印info级别的选项,可以这样执行:
gradle -i start
想打印debug级别的日志,可以这样执行(内容过多,看一部分):
gradle -d start
想看warn级别的日志,可以这样执行:
gradle -w start
想打印错误时的堆栈信息,可以这样执行(输入一个没有的task):
gradle -s start
各个参数也可以组合使用:
注意:参数选项写在中间或者最后都可以
其它重要的如下:
--help 打印出所有可用的命令行选项,包括描述信息
-b,--build-file gradle默认构建脚本是build.gradle,使用这个可以指定一个其它名字的脚本
--offline 离线模式运行,仅仅在本地缓存中查询依赖是否存在
-q 减少构建出错时打印出来的错误日志信息
Gradle守护进程
当gradle成为工作的一部分时,你会发现需要重复的构建。改变一个类就需要构建,然后部署,很多人喜欢测试驱动的开发方式,不断的运行单元测试。不管哪种方式,效率很重要,每次初始化一个构建,JVM都要重启一次,Gradle的依赖都要载入到类加载器中,还要建立项目对象模型,这个过程可能要花上好几秒。Gradle守护进程可以解决这个问题!
守护进行以后台进程方式运行Gradle,一旦启动,gradle命令就会在后续的构建中重用之前创建的守护进程,以避免启动时造成的开销。在命令中启用守护进程很简单,在执行task时加上--daemon即可,启动守护进程会话费一点点时间,但是后续的命令都会重用守护进程。
gradle start --daemon
守护进程会在三个小时后过期,如果不使用守护进程,可以这样执行:
gradle start --no-daemon
要停止守护进程,可以这样执行:
gradle --stop