Android中Gradle

最近研究下Android的Gradle，查到一些资料，记录下来，方便以后查找。
     1、关于Module和Task
     任何一个Gradle构建，都是由一个或者多个Module组成。每个Module是一个独立的功能模块，比如构建一个jar包，构建一个web应用等；
     每个Module可以包含多个Task，每个Task代表了构建过程中的一个操作，比如编译、打包、发布等。
      2、关于build.gradle
     build.gradle是Android studio的Moudle构建脚本，每个Moudle都包含一个build.gradle文件，里面定义了一系列的Task。gradle命令会调用当前目录下的build.gradle文件，关于build.gradle的，

apply plugin: 'com.android.library'

android {
    compileSdkVersion 17
    buildToolsVersion "23.0.2"

    defaultConfig {
        minSdkVersion 17
        targetSdkVersion 17
        versionCode 1
        versionName "1.0"
    }
    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
        }
    }
}

dependencies {
    provided files('libs/android-support-v4.jar')
}

task clearJar(type: Delete) {
    delete 'build/outputs/dlplugin.jar'
}

task makeJar(type: Copy) {
    from('build/intermediates/bundles/release/')
    into('build/outputs/')
    include('classes.jar')
    rename ('classes.jar', 'dlplugin.jar')
}

makeJar {}.dependsOn(clearJar,build)

compileSDKVersion:SDK的版本号，也就是API-Level，比如API-17,API-18等；

buildToolsVersion:构建工具版本号，包含了打包工具aapt，dx等，路径位于：(sdk路径)/build-tools/xx.xx.xx；

minSdkVersion:支持的最小SDK版本号

tagetSdkVersion:用于兼容SDK。

minifyEnabled:是否混淆设置

proguardFiles:混淆文件配置

示例中的task的功能：拷贝生成的jar包到指定目录，并且改名称。

在命令行执行gradle makeJar，直接点击运行按钮不行，后面要查下原因。

3、关于Task

3.1 编写第一个编译脚本

新建一个文件build.gradle，然后添加以下代码：

[plain]  view plain  copy

 

1. task hello {  
2.     doLast {  
3.         println 'Hello, Gradle!'  
4.     }  
5. }  

这是本系列文章里的第一个构建脚本，它定义了一个叫hello的task，task的内容是在最后打印出“Hello, Gradle!”。

我们输入命令gradle hello来执行它：

[plain]  view plain  copy

 

1. msdx@msdx-ubuntu:~/tmp$ gradle hello  
2. :hello  
3. Hello, Gradle!  
4.   
5. 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 快速定义任务

上面的代码，还有一种更简洁的写法，如下：

[plain]  view plain  copy

 

1. task hello << {  
2.     println 'Hello, Gradle!'  
3. }  

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

4 代码即脚本

Gradle脚本是采用Groovy编写的，所以也像Groovy一样，以脚本方式来执行代码，如下面例子：

[plain]  view plain  copy

 

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

执行结果如下，它将定义的字符串转为大写：

[plain]  view plain  copy

 

1. msdx@msdx-ubuntu:~/tmp$ gradle -q upper  
2. Original: mY_nAmE  
3. Upper case: MY_NAME  

这也就是说，我们在写Gradle脚本的时候，可以像写Groovy代码一样。而Groovy是基于Java的，兼容Java语法，所以Java的朋友们，是不是忽然发现Gradle脚本很好上手了呢？

5 任务依赖

我们可以通过以下方式创建依赖：

[plain]  view plain  copy

 

1. task hello << {  
2.     print 'Hello, '  
3. }  
4. task intro(dependsOn: hello) << {  
5.     println "Gradle!"  
6. }  

定义一个任务hello，输出“Hello, ”，然后定义一个任务intro，并依赖hello，输出“Gradle!”。结果是打印出“Hello, Gradle!”，如下：

[plain]  view plain  copy

 

1. msdx@msdx-ubuntu:~/tmp$ gradle -q intro  
2. Hello, Gradle!  

另外，被依赖的task不必放在前面声明，在后面也是可以的，这一点在后面将会用到。

6 动态任务

借助于强大的Groovy，我们还可以动态地创建任务。如下代码：

[plain]  view plain  copy

 

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

我们定义了4个task，分别是task0, task1, task2, task3。我们来执行task1，如下：

[plain]  view plain  copy

 

1. msdx@msdx-ubuntu:~/tmp$ gradle -q task1  
2. I'm task number 1  

另外，gradle tasks命令可以查看我们定义的task，从这里我们也可以看到定义的task，如下：

[plain]  view plain  copy

 

1. ...  
2. Other tasks  
3. -----------  
4. task0  
5. task1  
6. task2  
7. task3  
8. ...  

注意，如果任务还未定义，不能使用短标记法（见本篇后续内容）来运行任务。

7 任务操纵

在Gradle当中，任务创建之后可以通过API进行访问，这是Gradle与Ant的不同之处。

7.1 增加依赖

还是以上面的例子，但是我们添加一行代码，如下：

[plain]  view plain  copy

 

1. 4.times { counter ->  
2.     task "task$counter" << {  
3.         println "I'm task number $counter"  
4.     }  
5. }  
6. task1.dependsOn task0, task3  

然后还是执行 gradle -q task1，看看结果：

[plain]  view plain  copy

 

1. msdx@msdx-ubuntu:~/tmp$ gradle -q task1  
2. I'm task number 0  
3. I'm task number 3  
4. I'm task number 1  

它先执行了task0和task3，因为task1依赖于这两个。

7.2 增加任务行为

如下代码：

[plain]  view plain  copy

 

1. task hello << {  
2.     println 'Hello, Gradle!'  
3. }  
4. hello.doFirst {  
5.     println 'I am first.'  
6. }  
7. hello.doLast {  
8.     println 'I am last.'  
9. }  
10. hello << {  
11.     println 'I am the the last'  
12. }  

执行后的输出：

[plain]  view plain  copy

 

1. msdx@msdx-ubuntu:~/tmp$ gradle -q hello  
2. I am first.  
3. Hello, Gradle!  
4. I am last.  
5. I am the the last  

8 短标记法

如果你对groovy有一定了解，那你也许会注意到，每个task都是一个构建脚本的属性，所以可以通过“$”这种短标记法来访问任务。如下：

[plain]  view plain  copy

 

1. task hello << {  
2.     println 'Hello, Gradle!'  
3. }  
4. hello.doLast {  
5.     println "Greetings from the $hello.name task."  
6. }  

执行结果：

[plain]  view plain  copy

 

1. msdx@msdx-ubuntu:~/tmp$ gradle -q hello  
2. Hello, Gradle!  
3. Greetings from the hello task.  

注意，通过这种方法访问的任务一定是要已经定义的。

9 增加自定义属性

[plain]  view plain  copy

 

1. task myTask {  
2.     ext.myProperty = "myValue"  
3. }  
4.   
5. task printTaskProperties << {  
6.     println myTask.myProperty  
7. }  

输出结果：

[plain]  view plain  copy

 

1. msdx@msdx-ubuntu:~/tmp$ gradle -q printTaskProperties  
2. myValue  

10. 调用Ant任务

比如利用AntBuilder执行ant.loadfiile。

[plain]  view plain  copy

 

1. task loadfile << {  
2.     def files = file('config').listFiles().sort()  
3.     files.each { File file ->  
4.         if (file.isFile()) {  
5.             ant.loadfile(srcFile: file, property: file.name)  
6.             println " *** $file.name ***"  
7.             println "${ant.properties[file.name]}"  
8.         }  
9.     }  
10. }  

执行结果：

[plain]  view plain  copy

 

1. msdx@msdx-ubuntu:~/tmp$ gradle -q loadfile  
2.  *** db.config ***  
3. db=mysql  
4. username=root  
5. password=123456  
6.   
7.  *** user.config ***  
8. username=admin  
9. writeable=true  

11 方法抽取

在上面的脚本中，我们可以把部分代码抽取出来，如下：

[plain]  view plain  copy

 

1. task loadfile << {  
2.     fileList('config').each { File file ->  
3.         ant.loadfile(srcFile: file, property: file.name)  
4.         println " *** $file.name ***"  
5.         println "${ant.properties[file.name]}"  
6.     }  
7. }  
8. File[] fileList(String dir) {  
9.     file(dir).listFiles({file -> file.isFile() } as FileFilter).sort()  
10. }  

执行结果一样。

12. 定义默认任务

[plain]  view plain  copy

 

1. defaultTasks 'clean', 'run'  
2.   
3. task clean << {  
4.     println 'Default Cleaning!'  
5. }  
6.   
7. task run << {  
8.     println 'Default Running!'  
9. }  
10.   
11. task other << {  
12.     println "I'm not a default task!"  
13. }  

执行结果：

[plain]  view plain  copy

 

1. msdx@msdx-ubuntu:~/tmp$ gradle -q   
2. Default Cleaning!  
3. Default Running!  

13 DAG配置

Gradle使用DAG（Directed acyclic graph，有向非循环图）来决定任务执行的顺序。通过这一特性，我们可以实现依赖任务做不同输出。

如下代码：

[plain]  view plain  copy

 

1. task distribution << {  
2.     println "We build the zip with version=$version"  
3. }  
4.   
5. task release(dependsOn: 'distribution') << {  
6.     println 'We release now'  
7. }  
8.   
9. gradle.taskGraph.whenReady {taskGraph ->  
10.     if (taskGraph.hasTask(release)) {  
11.         version = '1.0'  
12.     } else {  
13.         version = '1.0-SNAPSHOT'  
14.     }  
15. }  

执行结果如下：

[plain]  view plain  copy

 

1. msdx@msdx-ubuntu:~/tmp$ gradle -q distribution  
2. We build the zip with version=1.0-SNAPSHOT  
3. msdx@msdx-ubuntu:~/tmp$ gradle -q release  
4. We build the zip with version=1.0  
5. We release now  
6. msdx@msdx-ubuntu  

在上面的脚本代码中，whenReady会在release任务执行之前影响它，即使这个任务不是主要的任务（即不是通过命令行传入参数来调用）。

在一个Android项目的build.gradle中，dependencies闭包中有以下四种形式的声明：

compile 'com.android.support:appcompat-v7:22.2.1'

provided 'com.squareup.dagger:dagger-compiler:1.2.1'

compile files('libs/picasso-2.4.0.jar')

compile project(':androidPullToRefresh')

1 是从repository（默认是jCenter())里下载一个依赖包进行编译并打包
3 是从本地的libs目录下寻找picasso-2.4.0.jar这个文件进行编译并打包。类似的命令有`compile fileTree(dir: 'libs', include: '*.jar')`——将libs目录下所有jar文件进行编译并打包。
4 是将另一个module（等同eclipse中的library)进行编译并打包

至于provided，是提供给那些只编译不打包场景的命令。就是，我在编译的时候对某一个jar文件有依赖，但是最终打包apk文件时，我不想把这个jar文件放进去，可以用这个命令。目前我知道的就一个插件化的场景需要用到这个命令，如果搞不明白，可以先不管。

本文原创，参考自Gradle官方文档，可看作是阅读该文档的笔记。转载请注明本段内容及本文出处：http://blog.youkuaiyun.com/maosidiaoxian/article/details/40340571