Gradle 教程说明 用户指南 1~6章

要使用Android Studio，就需要这个构建工具。

本文是一个粗略的 官方用户指南 前6章的笔记，以示例驱动。

下载好最新版的Gradle(当前为2.2)后，解压。将Gradle的bin目录配置到环境变量中，以便在shell中可以使用gradle命令。

随便新建个目录(我这里建了一个名为builds的目录)，cd进去，新建一个build.gradle文件，以下示例都编辑在build.gradle中。

说明：> 后 跟gradle命令。 -q参数会关闭一些命令中的log信息，如 gradle -q hello

定义一个任务，并执行

task hello {
    doLast {
        println 'Hello world!\nadmin'
    }
}

> gradle hello

定义一个快捷任务

task hello2 << {
        println 'admin\nHello world!'
    
}

> gradle hello2

<< 代表 doLast{}

使用Groovy 语言

task upper << {
    String someString = 'mY_nAmE'
    println "Original: " + someString 
    println "Upper case: " + someString.toUpperCase()
}

> gradle upper

循环遍历

task foreach << {
    10.times { println "the times is $it." }
}

> gradle foreach

10.times，循环条件<10；$it 表示循环变量

依赖其他任务

task intro(dependsOn: hello) << {
    println "I'm Gradle---intro"
}

> gradle intro

依赖任务hello，会先调用hello，再执行当前task

依赖的任务定义在当前任务之后

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

> gradle taskX

依赖定义在后面的任务，需要在任务名上加单引号。 而上一个例子，加不加单引号都可以

动态任务

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

> gradle test[0-4]

循环四次，生成4个task， 任务名分别为task0,task1,task2,task3。

动态任务依赖动态任务

task0.dependsOn task2, task3

> gradle task0

当然动态依赖静态，静态依赖动态都是可以的

符号<< 和 doFirt、doLast

task hello3 << {
    println 'Hello Earth'
}
hello3.doFirst {
    println 'Hello Venus'
}
hello3.doLast {
    println 'Hello Mars'
}
hello3 << {
    println 'Hello Jupiter'
}

> gradle hello3

可以有多个doFirst和doLast(或<<)。doFirtst先执行，doLast在其后。这里顺序就应为：Venus、Earth、Mars、Jupiter

使用外部任务的属性

task myTask {
    ext.myProperty = "myValue"
}
task extraProps << {
    println myTask.myProperty
}

> gradle extraProps

使用ant任务

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

> gradle loadfile1

调用任务ant.properties。这里输出了文件的内容

使用ant任务，并调用了Method

task checksum << {
    fileList('../builds').each {File file ->
        ant.checksum(file: file, property: "cs_$file.name")
        println "$file.name Checksum: ${ant.properties["cs_$file.name"]}"
    }
}
task loadfile2 << {
    fileList('../builds/').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 loadfile2

> gradle checksum

声明了method ---- fileList()

默认任务 

defaultTasks 'clean', 'run'

task clean << {
    println 'Default Cleaning!'
}
task run << {
    println 'Default Running!'
}
task other << {
    println "I'm not a default task!"
}

> gradle

后不跟任务名即 执行默认任务

Configure by DAG

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'
    }
}

> gradle distribution

运行任务图中没有release-task，输出 We build the zip with version=1.0-SNAPSHOT

> release

运行任务图中有release-task，输出 We build the zip with version=1.0