学习写Gradle构建脚本（一）-CSDN博客

文章内容来自Gradle官方的user-guide文档

构建脚本的基本内容

工程(projects)和任务(tasks)

每一个构建脚本都是由一个或者多个工程组成。
一个工程由一个或多个任务组成。

一个HelloWorld工程

gradle 命令会去寻找当前目录的build.gradle文件，这个文件就是我们的构建脚本。
我们到一个空目录下，新建一个build.gradle文件，输入如下内容

task hello {
    doLast {
    println 'Hello World!'
    }
}

在命令行里输入 gradle -q hello 就会看见输出如下内容：

Hello World!

-q 的意思是 quiet,即不输出任何的日志，直接输出任务相关的内容。
上面的 build.gradle 就定义了一个hello任务, 在任务里面添加一个动作，
动作执行一段代码，就是输出 Hello World! 。当执行 gradle -q hello 时，
Gradle会执行hello任务。

一个简化的任务定义

task hello << {
    println 'Hello World!'
}

<<操作符类似于doLast的别名

构建脚本实际上是代码

Gradle的构建脚本能够使用Groovy语言的所有强大功能。如：

task count {
    doLast {
    4.times { print "$it " }
    }
}

gradle -q count

0 1 2 3

任务之间的依赖

taskX依赖taskY的声明方式

task taskX(dependsOn: 'taskY') << {
    println 'Task X'
}

task taskY << {
    println 'Task Y'
}

taskX依赖taskY，但是taskY还没有声明，这是一种延迟依赖(Lazy dependsOn)。
输出如下，先执行依赖的任务

gradle -q taskX

Task X

Task Y

动态任务

利用Groovy动态创建任务

4.times { counter ->
    task "task$counter" {
    doLast {
        println "I'm task number $counter" 
    }
    }

}

可以动态创建task1-task4

gradle -q task3

I’m task number 3

操作存在的任务

任务被创建后就可以通过API访问。可以动态的添加依赖

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

gradle -q task0
I’m task number 2
I’m task number 3
I’m task number 0

简短的记号

有一些很方便的记号能够访问一个存在的任务。没一个任务可以作为构建脚本的属性。

task notation {
    doLast {
    println 'Hello World!'
    }
}

notation.doLast {
    println 'This is $notation.name task!'
}

gradle -q notation
Hello World!
This is $notation.name task!

自定义的项目属性

可以给任务添加自己的属性。

task myProperty {
    ext.time = "time is now" 
}

task printMyProperty {
    doLast {
    println myProperty.time
    }
}

gradle -q printMyProperty

time is now

使用Ant任务

Gradle很好的集成了Ant任务通过简单的依赖Groovy。通过Gradle使用Ant任务是更加强大和方便。
下面这个例子介绍了怎样执行Ant任务和怎样访问Ant属性。

task loadfile {
    doLast {
    def files = file('.').listFiles().sort()
    files.each { File file ->
        if (file.isFile()) {
        ant.loadfile(srcFile : file, property: file.name)
        println " *** $file.name ***"
        println "${ant.properties[file.name]}"
        }
    }
    }
}

当前目录只有build.gradle,所以输出如下

* build.gradle *

task loadfile {

doLast {

def files = file(‘.’).listFiles().sort()

files.each { File file ->

if (file.isFile()) {

ant.loadfile(srcFile : file, property: file.name)

println ” * $file.name *”

println “${ant.properties[file.name]}”

}

}

}

}

更多的Ant的操作会在后面介绍

方法的使用

Gradle定义方法来组织逻辑。

task checksum {
    doLast {
    fileList('.').each { File file ->
        ant.checksum(file: file, property: "cs_$file.name")
        println "$file.name Checksum: ${ant.properties["cs_$file.name"]}"
    }
    }
}
task loadfile {
    doLast {
    fileList('.').each { File file ->
        ant.loadfile(srcFile: file, property: file.name)
        println "I'm fond of $file.name"
    }
    }
}
File[] fileList(String dir) {
    file(dir).listFiles({file -> file.isFile() } as FileFilter).sort()
}

默认任务

Gradle可以定义一个或多个任务，如果没有其他的任务被指定，默认任务就会执行。

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 -q

Default Cleaning!

Default Running!

通过DAG配置

Gradle有一个配置解析期(configuration phase)和一个执行解析期(execution phase)。
在配置解析完成后，Gradle知道了所有应该被执行的任务。为了使用这些信息，Gradle
提过了一个钩子(hook)。这样我们就可以给变量不同的值。

下面的例子中，version变量的值取决于执行的任务是哪个。

task distribution {
    doLast {
    println "We build the zip with version=$version"
    }
}

task release(dependsOn: 'distribution') {
    doLast {
    println "We release now"
    }
}

gradle.taskGraph.whenReady { taskGraph -> 
    if (taskGraph.hasTask(release)) {
    version = 1.0
    } else {
    version = '1.0-SNAPSHOT'
    }
}

不同的执行结果如下