【Gradle】Gradle构建脚本基础

电玩女神 2023-06-04 02:55 44阅读 0赞

# Gradle构建脚本基础 #

## Settings文件 ##

在Gradle中，定义了一个设置文件，用于初始化以及工程树的配置。设置文件的默认名为settings.gradle,放在根工程目录下。

设置文件大多数的作用都是为了配置子工程。根工程相当于Android Studio中的Project，一个根工程可以有很多子工程。

一个子工程只有在Settings文件里配置了Gradle才会识别，才会在构建的时候被包含进去。

rootProject.name = 'android-gradle'
    
    include ':Chapter1'
    project(':Chapter1').projectDir = new File(rootDir,'Chapter1')
    
    include ':Chapter2'
    project(':Chapter2').projectDir = new File(rootDir,'Chapter2')
    
    include ':Chapter3'
    project(':Chapter3').projectDir = new File(rootDir,'Chapter3')

上面的配置，定义了一些子项目，并且为它们指定了相应的目录。如果不指定，则默认为同级目录。利用这个特性，我们可以把我们的工程放到任何目录下，可以非常灵活地对我们的工程进行分级，分类等。只要在Settings文件里指定好路径就可以了。

## Build文件 ##

每个Project都会有一个Build文件，该文件是该Project构建的入口，可以在这里对Project进行配置，比如配置版本，需要哪些插件，依赖哪些库等。

Root Project也有自己的Build文件。Root Project 可以取到所有的Child Project，所以在Root Project的Build文件里可以对Child Project统一配置，如应用的插件，依赖的Maven中心库等。比如配置所有的Child Project的仓库为jcenter：

subprojects{
        repositories{
            jcenter()
        }
    }

又比如，开发一个大型的Java工程，该工程被分为很多小模块，每个模块都是一个Child Project，这些模块也是Java工程，这种情况下可以统一配置：

subprojects{
        apply plugin:"java"
        repositories{
            jcenter()
        }
    }

除了subprojects外，还有allprojects,用于对所有工程进行配置。

## Projects以及Tasks ##

一个Project包含很多个Task，也就是说每个Project是由多个Task组成的。

## 创建一个任务 ##

task customTask1{
        doFirst{
            println 'customTask1:doFirst'
        }
        doLast{
            println 'customTaks1:doLast'
        }
    }

创建任务的另一种方式:

tasks.create("customTask2"){
        doFirst{
            println 'customTask2:doFirst'
        }
        doLast{
            println 'customTask2:doLast'
        }
    }

## 任务依赖 ##

任务之间是可以有依赖关系的，这样我们就能控制哪些任务优先于哪些任务执行。

创建任务的时候，通过dependsOn可以指定依赖的任务

task customTask3(dependsOn:customTask2){
        doLast{
            println 'customTask3:doLast'
        }
    }

另外，一个任务可以依赖多个任务

task customTask4{
        dependsOn customTask3,customTask1
        doLast{
            println 'customTask4:doLast'
        }
    }

## 任务间通过API控制、交互 ##

要使用任务名操作任务，必须先定义声明，因为脚本是顺序执行的。

task customTask5{
        println 'customTask5'
    }
    
    customTask5.doFirst{
        println 'customTask5:doFirst'
    }
    
    customTask5.doLast{
        println 'customTask5:doLast'
    }

## 自定义属性 ##

Project和Task都允许用户添加额外的自定义属性，要添加自定义属性，通过应用所属对应的ext即可实现。添加之后，通过ext属性可以读取和设置，如果要同时添加多个自定义属性，可以通过ext代码块来实现。

ext.name='张三'
    
    ext{
        age = 18
        address = '中国'
    }
    
    task customTask6{
        println "姓名是:${name},年龄是:${age},地址是：${address}"
    }

相比局部变量，自定义属性有更为广泛的作用范围。可以跨Project，跨Task访问这些自定义的属性。只要能访问到这些属性所属的对象，这些属性就可以被访问到。

自定义属性不仅仅局限在Project和Task上，还可以应用在SourceSet中。

apply plugin:"java"
    
    sourceSets.all{
        ext.resourcesDir = null
    }
    
    sourceSets{
        main{
            resourcesDir= 'main/res'
        }
        test{
            resourcesDir = 'test/res'
        }
    }
    
    task customTask7{
        sourceSets.each{
            println "${it.name}的resourcesDir是:${it.resourcesDir}"
        }
    }

在项目中，一般使用它来自定义版本和版本名称，把版本号和版本名称单独放在一个Gradle文件中。

## 脚本即代码，代码即脚本 ##

转载于:https://www.cnblogs.com/milovetingting/p/11412949.html