Android学习笔记第1章 Android应用和开发环境 1.2 使用Gradle自动化构建项目 1.2.2 Gradle构建文件和创建任务

快来打我* 2024-03-26 15:12 22阅读 0赞

#### Android学习笔记 ####

#### 文章目录 ####

*   *   *  Android学习笔记
         *  第1章 Android应用和开发环境
         *   *  1.2 使用Gradle自动化构建项目
             *   *  1.2.2 Gradle构建文件和创建任务

> 疯狂Android讲义

#### 第1章 Android应用和开发环境 ####

##### 1.2 使用Gradle自动化构建项目 #####

###### 1.2.2 Gradle构建文件和创建任务 ######

其实使用Gradle非常简单，只要安装正确后，使用gradle或者gradle.bat 就行了。

如果运行gradle命令时没有指定任何参数，Gradle会在当前目录下搜索 build.gradle 文件，如果找到就以该文件作为构建文件，并执行指定任务。

也可以用–buildfile <构建文件> (或写成 -b)选项来指定构建文件。【显式指定】

希望Gradle 运行时只输出少量的必要信息，使用 --quiet 或写成 -q

运行Gradle 显式指定希望运行的任务，

gradle [task1 [task2 [task3] ...]]

查看帮助： -h

![在这里插入图片描述][4dcaf9fc37b848ef890aebe0f56f69d4.png_pic_center]

使用Gradle 的关键就是编写构建文件。

构建文件的主要作用就是定义构建项目的各种任务(Task)和属性，每个任务可包含多个动作(Action),Gradle每次运行时可运行一个或多个任务。

Gradle构建文件的默认名字为build.gradle,也可以取其他名字。但如果为该构建文件起其他名字，则意味着要将这个文件名作为参数传给Gradle工具。可以将构建文件放在项目的任何位置，但通常做法是放在项目的根目录中，这样有利于保持项目的简洁和清晰。

一个典型的Gradle 项目层次结构：

<project>：整个项目全部资源

*  src：分类存放各种源文件、资源文件
    
     *  main：主要存放和项目有关的源文件和资源
        
         *  java：与项目有关的Java 源文件
         *  resources：与项目有关的资源
     *  test：与测试相关的源文件和资源
        
         *  java：与测试相关的Java 源文件
         *  resources：存放与测试相关的资源
 *  build：存放编译后的class文件、资源的文件夹，该文件夹与src具有对应关系
 *  libs：存放第三方JAR包的文件夹
 *  build.gradle：Gradle 构建文件

如果使用gradle命令构建过项目，那么在项目的根目录下会多出一个.gradle文件夹，在该文件夹中存放的是Gradle的构建信息，一般不要手动去修改、删除它。

![在这里插入图片描述][126537da0fe445dca4281c42afe6f631.png_pic_center]

Gradle构建文件本质上是一个Groovy源文件，因此该文件的语法完全符合Groovy语法。

Gradle采用**领域对象模型**的概念来组织构建文件，在整个构建文件中涉及如下最核心的API：

*  Project:代表项目，通常一份构建文件代表一个项目。Project包含大量属性和方法。
 *  TaskContainer:任务容器。每个Project都会维护一个TaskContainer类型的tasks属性。简而言之，Project和TaskContainer有一一对应的关系。
 *  Task:代表Gradle要执行的一个任务。Task允许指定它依赖的任务、该任务的类型，也可通过configure(方法配置任务。它还提供了doFirst()、doLast()方法来添加Action。Action对象和Closure【Closure代表一个闭包，所以Action实际上就代表一个代码块】对象都可代表Action。

Gradle 构建文件的逻辑结构：

![在这里插入图片描述][064678e263da40f49a86d1bf80c81dfe.png_pic_center]

为Gradle 构建文件创建Task的常用方法：

*  调用Project的task()方法创建Task。
 *  调用TaskContainer的create()方法创建Task。

不管使用哪种方式来创建Task,通常都可为Task指定如下个常用属性。

*  通过dependsOn属性指定该Task所依赖的其他Task。
 *  通过type属性指定该Task的类型。
 *  通过传入的代码块参数配置Task。

举个栗子：

// 定义hello1任务，传入的代码块负责配置该任务
    task hello1{
        
        println "配置第一个任务"
    }

![在这里插入图片描述][f05ce3e58f29405390b537ae0a6f8dd4.png_pic_center]

调用task方法定义了一个名为 hello1 的任务，在创建hello1 任务时传入了一个代码块，在该代码块中包含了一行简单的打印语句

gradle hello1运行

![在这里插入图片描述][44bcd19d1d074bd390e49b1e17500f2c.png_pic_center]

没问题，println 语句执行了。而且是在配置阶段输出的。

Gradle的构建过程说明：

Gradle 是一种声明式构建工具，使用Gradle 构建时，Gradle 并不是直接按顺序执行build.gradle 文件中的内容。

Gradle的构建过程可分为两个阶段：

*  第一阶段
    
    配置阶段。在此阶段，Gradle会读取build.gradle文件的全部内容来配置Project和Task,比如设置Project和Task的Property、处理Task之间的依赖关系等。
 *  第二阶段
    
    按依赖关系执行指定Task。

在创建Task 时传入的代码块用于配置该Task，所以上面hello1 任务后代码的打印语句会在配置阶段执行，而不是运行阶段。

如果需要为Task添加Action,则可通过Task的doFirst、doLast方法。

如它们的名字所暗示的，doFirst用于将Action添加在Action序列的前面，doLast用于将Action添加在Action序列的后面。

举个栗子：

上面代码同样调用task方法定义了一个hello2任务，该任务的配置代码的第一行是println输出语句；接下来依次使用doLast、doFirst方法添加了两个Action。

使用doLast、doFirst方法添加的Action就是一个代码块，在这个代码块内完全可定义变量，也可使用循环等流  
程控制语句，只要这些语句符合Groovy语法即可。

Gradle构建文件不是简单的XML配置，而是完全支持Groovy编程语言，这就可以让Gradle构建文件增加无限的可  
能性。【牛逼！！！！！！】

使用gradle hello2命令来执行hello2任务

![在这里插入图片描述][5abace6b2f0745109be3a05b385f497b.png_pic_center]

这样就很清晰了，Gradle 构建的配置和运行两个阶段。

在配置阶段，Gradle会配置整个Project和所有Task,因此可以看到hello1、hello2两个Task的配置代码的执行过程；

在运行阶段，则只看到执行hello2任务。从上面的执行结果可以看出，程序先执行doFirst方法添加的Action,再执行doLast方法添加的Action。

此外，Project对象还带一个TaskContainer类型的tasks属性，因此也可在构建文件中通过tasks属性的create方法来创建Task。

举个栗子示范使用tasks属性的create方法来创建Task。

上面代码使用create方法创建了一个名为“showTasks”的Task,使用create方法传入的代码块用于配置该Task。

该代码块只是使用doLast为该Task添加了一个Action,该Action用于访问tasks属性的类型，并遍历该构建文件所包含的Task。

使用`gradle showTasks`命令来执行showTasks任务

![在这里插入图片描述][2698a594d75f4522a97097bff97f1af7.png_pic_center]

妙啊

在创建Task时可通过dependsOn属性指定该Task所依赖的Task,也可通过type指定该Task的类型。

如果不指定type属性，Task的默认类型是Gradle实现的DefaultTask类。

下面代码使用tasks属性的create方法来创建Task,并指定dependsOn和type属性

上面代码定义了一个名为“DingJiaxiongTask”的Task,该Task依赖hello2,且该Task的类型为Copy(完成文件复制的Task，该任务的from方法指定被复制的源文件，into方法指定复制的目标位置，该任务的默认Action将会完成文件复制。

执行任务前

![在这里插入图片描述][26471894d9ce42d0a016d71abbe6a670.png_pic_center]

`gradle DingJiaxiongTask`

![在这里插入图片描述][8b33253ff76d48d992e82cb8179399c0.png_pic_center]

![在这里插入图片描述][25e77edc8ea64dfd80149cbfdeb12b89.png_pic_center]

拷贝成功

从上面的执行过程可以看出，由于DingJiaxiongTask任务依赖hello2,因此在执行DingJiaxiongTask任务之前会先执行hello2任务。

上面命令执行完成后，可以看到项目根目录下的dingjiaxiong.xml文件被复制到dist目录下。

使用Project的task方法创建Task时也可指定type、dependsOn属性，例如如下代码定义了compile和run两个任务。

由于这两个任务分别为JavaCompile、JavaExec类型，因此该构建文件需要应用java插件。

简单准备一个Java 源代码

![在这里插入图片描述][081ddb4ba8fc4f529405eb2fcedebd5e.png_pic_center]

package dingjiaxiong;
    
    public class HelloWorld{
        
        public static void main(String[] args) {
        
            System.out.println("Hello world,hello Ding Jiaxiong!");
        }
    }

// 定义hello1任务，传入的代码块负责配置该任务
    task hello1{
        
        println "配置第一个任务"
    }
    
    // 定义hello2任务，传入的代码块负责配置该任务
    task hello2{
        
        println "配置第二个任务"
        // 调用doLast 方法为Task 添加Action
        doLast{
        
            // 使用循环
            for(i in 0..<5){
        
                println i
            }
        }
        // 调用doFirst方法为Task添加Action
        doFirst{
        
            // 定义变量
            def s = "Ding Jiaxiong"
            // 输出字符串模板
            println "开始执行第二个任务: $s"
        }
    }
    
    // 调用Project的tasks属性(TaskContainer) 的create方法来创建Task
    tasks.create(name: 'showTasks'){
        
        doLast{
        
            // 查看Project的tasks属性的类型
            println "tasks属性的类型: ${
          tasks.class}"
            // 遍历tasks属性
            tasks.each{
        e -> 
                println e
            }
        }
    }
    
    // 调用Project的tasks属性(TaskContainer) 的create方法来创建Task
    // dependOn指定该Task依赖hello2, 该Task的类型是Copy(文件拷贝)
    tasks.create(name:'DingJiaxiongTask',dependsOn:'hello2',type:Copy){
        
        from 'dingjiaxiong.xml'
        into 'dist'
    }
    
    // 应用名为java的插件, 为了引入JavaCompile、JavaExec两个任务
    apply plugin: 'java'
    // 指定该任务的类型为JavaCompile
    task compile(type: JavaCompile){
        
        source = fileTree('src/main/java')
        classpath = sourceSets.main.compileClasspath
        destinationDir = file('build/classes/main')
        options.fork = true
        options.incremental = true
    }
    
    // 指定该任务的类型为JavaExec
    task run(type: JavaExec,dependsOn: 'compile'){
        
        classpath = sourceSets.main.runtimeClasspath
        // 指定主类为dingjiaxiong.HelloWorld
        main = 'dingjiaxiong.HelloWorld'
    }

上面代码定义的compile任务的类型是JavaCompile(编译Java源程序的Task)，在使用JavaCompile时需要通过source指定源代码所在路径，通过destinationDir指定编译后的字节码文件的保存位置，该任务的默认Action将会  
编译所有Java源文件。

上面run任务的类型是JavaExec(运行Java程序的Task)，在使用JavaExec时需要通过main指定运行的主类。

为了看到Gradle编译、运行Java源代码的效果，应按Gradle的约定，将所有Java源文件放在src\\main\\java目录下，并创建build路径作为构建目录。

直接gradle run！

![在这里插入图片描述][61463ad140d7497a93cc504c3f322970.png_pic_center]

可以看到，Gradle先执行compile 编译任务，然后再执行run 任务

我靠，真的这样就对Android Studio 的构建过程更清晰了。【厉害】

[4dcaf9fc37b848ef890aebe0f56f69d4.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/26/eab3dd321f55497fb182c74434da558b.png
[126537da0fe445dca4281c42afe6f631.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/26/e75576a045e14b0eafba8ffef09d087a.png
[064678e263da40f49a86d1bf80c81dfe.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/26/03a3cb65af324f19aba36ab5ea913837.png
[f05ce3e58f29405390b537ae0a6f8dd4.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/26/e64ef8b8eec04a3ab4cbb8d4f998b51b.png
[44bcd19d1d074bd390e49b1e17500f2c.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/26/5eccac8eb50c4be7a8ffd3f304094139.png
[5abace6b2f0745109be3a05b385f497b.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/26/e45de22420d94e7d937a8a5ef6b27986.png
[2698a594d75f4522a97097bff97f1af7.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/26/acad284a6ea04fc68dbf049515863e08.png
[26471894d9ce42d0a016d71abbe6a670.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/26/70f997e2da854b62a7ff59f0405a7804.png
[8b33253ff76d48d992e82cb8179399c0.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/26/fc5abb5051e449049b907459a15558eb.png
[25e77edc8ea64dfd80149cbfdeb12b89.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/26/fd1e7195b42843b8b17d47d98b7f5f79.png
[081ddb4ba8fc4f529405eb2fcedebd5e.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/26/30cbab897c9e450b84ce319fbc4f8e9a.png
[61463ad140d7497a93cc504c3f322970.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/26/dcb64577ddc34b2581f20c8de757c47d.png