Gradle笔记——构建基础
本篇文章主要介绍一下Gradle的构建基础。
它看起来似乎和android项目没多大关系。不能让人一下子理解android项目中的Gradle配置文件,可是这篇基础真的非常重要。
学习Gradle前,须要有一个Groovy语言的基础,以免被Groovy的语法困扰。反而忽略了Gradle的知识。这里有一个Groovy的简明中文教程文档,能够高速学习Groovy的一些语法:http://download.csdn.net/detail/maosidiaoxian/8049823
1 Projects和tasks
先明白两个概念,projects和tasks。它们是Gradle中的两个重要概念。
不论什么一个Gradle构建,都是由一个或多个projects组成的。Project就是你想要用Gradle做什么,比方构建一个jar包。构建一个web应用。Project也不单指构建操作,部署你的应用或搭建一个环境,也能够是一个project。
一个project由多个task组成。
每一个task代表了构建过程其中的一个原子性操作,比方编译。打包,生成javadoc,公布等等这些操作。
2 编写第一个构建脚本
task hello { doLast { println 'Hello, Gradle!' } }这是本系列文章里的第一个构建脚本,它定义了一个叫hello的task,task的内容是在最后打印出“Hello, Gradle!”。
msdx@msdx-ubuntu:~/tmp$ gradle hello :hello Hello, Gradle! BUILD SUCCESSFUL
一个project由多个task组成,一个task也是由多个action组成。
这个闭包就是一个Action。
它定义了一系列的诸如doLast, doFirst等抽象方法,详细能够看gradle api里org.gradle.api.Task的文档。
这事实上是Gradle打印出来的日志,假设不想输出这些内容,能够在gradle后面加上參数 -q。即:gradle -q hello。
3 高速定义任务
task hello << { println 'Hello, Gradle!' }
运行这个脚本,打印出来的是一样的。也就是我们把像doLast这种代码。直接简化为<<这个符号了。这事实上是Gradle利用了Groovy的操作符重载的特性。把左位移操作符实现为将action加到task的最后,相当于调用doLast方法。看Gradle的api文档里对doLast()和leftShift()这两个方法的介绍,可知它们的作用是一样的,所以在这里,<<左移操作符即doLast的简写方式。
4 代码即脚本
task upper << { String someString = 'mY_nAmE' println "Original: " + someString println "Upper case: " + someString.toUpperCase() }
运行结果例如以下。它将定义的字符串转为大写:
msdx@msdx-ubuntu:~/tmp$ gradle -q upper Original: mY_nAmE Upper case: MY_NAME这也就是说,我们在写Gradle脚本的时候。能够像写Groovy代码一样。而Groovy是基于Java的。兼容Java语法,所以Java的朋友们。是不是忽然发现Gradle脚本非常好上手了呢?
5 任务依赖
我们能够通过下面方式创建依赖:task hello << { print 'Hello, ' } task intro(dependsOn: hello) << { println "Gradle!" }
定义一个任务hello,输出“Hello, ”,然后定义一个任务intro,并依赖hello,输出“Gradle!”。结果是打印出“Hello, Gradle!”,例如以下:
msdx@msdx-ubuntu:~/tmp$ gradle -q intro Hello, Gradle!
另外。被依赖的task不必放在前面声明,在后面也是能够的,这一点在后面将会用到。
6 动态任务
例如以下代码:
4.times { counter -> task "task$counter" << { println "I'm task number $counter" } }
我们定义了4个task,各自是task0, task1, task2, task3。我们来运行task1。例如以下:
msdx@msdx-ubuntu:~/tmp$ gradle -q task1 I'm task number 1
另外。gradle tasks命令能够查看我们定义的task。从这里我们也能够看到定义的task,例如以下:
... Other tasks ----------- task0 task1 task2 task3 ...注意,假设任务还没有定义,不能使用短标记法(见本篇兴许内容)来执行任务。
7 任务操纵
7.1 添加依赖
4.times { counter -> task "task$counter" << { println "I'm task number $counter" } } task1.dependsOn task0, task3然后还是运行 gradle -q task1。看看结果:
msdx@msdx-ubuntu:~/tmp$ gradle -q task1 I'm task number 0 I'm task number 3 I'm task number 1它先运行了task0和task3,由于task1依赖于这两个。
7.2 添加任务行为
task hello << { println 'Hello, Gradle!' } hello.doFirst { println 'I am first.' } hello.doLast { println 'I am last.' } hello << { println 'I am the the last' }运行后的输出:
msdx@msdx-ubuntu:~/tmp$ gradle -q hello I am first. Hello, Gradle! I am last. I am the the last
8 短标记法
假设你对groovy有一定了解,那你或许会注意到。每一个task都是一个构建脚本的属性,所以能够通过“$”这样的短标记法来訪问任务。例如以下:task hello << { println 'Hello, Gradle!' } hello.doLast { println "Greetings from the $hello.name task." }
运行结果:
msdx@msdx-ubuntu:~/tmp$ gradle -q hello Hello, Gradle! Greetings from the hello task.
注意,通过这样的方法訪问的任务一定是要已经定义的。
9 添加自己定义属性
task myTask { ext.myProperty = "myValue" } task printTaskProperties << { println myTask.myProperty }
输出结果:
msdx@msdx-ubuntu:~/tmp$ gradle -q printTaskProperties myValue
10. 调用Ant任务
比方利用AntBuilder运行ant.loadfiile。
task loadfile << { def files = file('config').listFiles().sort() files.each { File file -> if (file.isFile()) { ant.loadfile(srcFile: file, property: file.name) println " *** $file.name ***" println "${ant.properties[file.name]}" } } }
运行结果:
msdx@msdx-ubuntu:~/tmp$ gradle -q loadfile *** db.config *** db=mysql username=root password=123456 *** user.config *** username=admin writeable=true
11 方法抽取
在上面的脚本中,我们能够把部分代码抽取出来。例如以下:
task loadfile << { fileList('config').each { File file -> ant.loadfile(srcFile: file, property: file.name) println " *** $file.name ***" println "${ant.properties[file.name]}" } } File[] fileList(String dir) { file(dir).listFiles({file -> file.isFile() } as FileFilter).sort() }
运行结果一样。
12. 定义默认任务
defaultTasks 'clean', 'run' task clean << { println 'Default Cleaning!' } task run << { println 'Default Running!' } task other << { println "I'm not a default task!" }
运行结果:
msdx@msdx-ubuntu:~/tmp$ gradle -q Default Cleaning! Default Running!
13 DAG配置
Gradle使用DAG(Directed acyclic graph。有向非循环图)来决定任务运行的顺序。通过这一特性,我们能够实现依赖任务做不同输出。
task distribution << { println "We build the zip with version=$version" } task release(dependsOn: 'distribution') << { println 'We release now' } gradle.taskGraph.whenReady {taskGraph -> if (taskGraph.hasTask(release)) { version = '1.0' } else { version = '1.0-SNAPSHOT' } }
msdx@msdx-ubuntu:~/tmp$ gradle -q distribution We build the zip with version=1.0-SNAPSHOT msdx@msdx-ubuntu:~/tmp$ gradle -q release We build the zip with version=1.0 We release now msdx@msdx-ubuntu在上面的脚本代码中。whenReady会在release任务运行之前影响它。即使这个任务不是基本的任务(即不是通过命令行传入參数来调用)。
本文原创,參考自Gradle官方文档,可看作是阅读该文档的笔记。转载请注明本段内容及本文出处:http://blog.csdn.net/maosidiaoxian/article/details/40340571