zoukankan      html  css  js  c++  java
  • 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 编写第一个构建脚本

    新建一个文件build.gradle,然后加入下面代码:
    task hello {
        doLast {
            println 'Hello, Gradle!'
        }
    }
    
    这是本系列文章里的第一个构建脚本,它定义了一个叫hello的task,task的内容是在最后打印出“Hello, Gradle!”。
    我们输入命令gradle hello来运行它:
    msdx@msdx-ubuntu:~/tmp$ gradle hello
    :hello
    Hello, Gradle!
    
    BUILD SUCCESSFUL
    
    Gradle是领域驱动设计的构建工具。在它的实现其中,Project接口相应上面的project概念。Task接口相应上面的task概念,实际上除此之外另一个重要的领域对象。即Action,相应的是task里面详细的某一个操作。

    一个project由多个task组成,一个task也是由多个action组成。

    当运行gradle hello的时候。Gradle就会去调用这个hello task来运行给定操作(Action)。这个操作事实上就是一个用Groovy代码写的闭包,代码中的task是Project类里的一个方法。通过调用这里的task方法创建了一个Task对象,并在对象的doLast方法中传入println 'Hello, Gradle!'这个闭包。

    这个闭包就是一个Action。

    Task是Gradle里定义的一个接口,表示上述概念中的task。

    它定义了一系列的诸如doLast, doFirst等抽象方法,详细能够看gradle api里org.gradle.api.Task的文档。


    在上面运行了gradle hello后。除了输出“Hello, Gradle!”之外,我们发现像“:hello”这种其它内容。

    这事实上是Gradle打印出来的日志,假设不想输出这些内容,能够在gradle后面加上參数 -q。即:gradle -q hello。


    3 高速定义任务

    上面的代码,另一种更简洁的写法,例如以下:
    task hello << {
        println 'Hello, Gradle!'
    }
    

    运行这个脚本,打印出来的是一样的。也就是我们把像doLast这种代码。直接简化为<<这个符号了。这事实上是Gradle利用了Groovy的操作符重载的特性。把左位移操作符实现为将action加到task的最后,相当于调用doLast方法。看Gradle的api文档里对doLast()和leftShift()这两个方法的介绍,可知它们的作用是一样的,所以在这里,<<左移操作符即doLast的简写方式。


    4 代码即脚本

    Gradle脚本是採用Groovy编写的。所以也像Groovy一样,以脚本方式来运行代码,如以下样例:
    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 动态任务

    借助于强大的Groovy。我们还能够动态地创建任务。

    例如以下代码:

    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 任务操纵

    在Gradle其中。任务创建之后能够通过API进行訪问,这是Gradle与Ant的不同之处。

    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


  • 相关阅读:
    空指针的问题,感觉自己很傻
    在运行微服务架构的时候报错error creating bean h name 'advisor'.. Unsatisfied dependency..constructor argument with index 0...
    hibernate+oracle+主键varchar2类型,增加序列策略注解失败
    hibernate的报错异常
    7777端口的问题
    soapUI模拟发送json数据时,遇到的中文编码问题
    三、数组的使用
    四、内存中的数组
    一、初步认识数组
    二、数组的初始化
  • 原文地址:https://www.cnblogs.com/zsychanpin/p/6939465.html
Copyright © 2011-2022 走看看