易优cms仿站教程,如何选择制作网站公司,网站模板用什么打开,丹东做网站哪家好build.gradle是gradle中非常重要的一个文件#xff0c;因为它描述了gradle中可以运行的任务#xff0c;今天本文将会带大家体验一下如何创建一个build.gradle文件和如何编写其中的内容。
project和task
gradle是一个构建工具#xff0c;所谓构建工具就是通过既定的各种规则…build.gradle是gradle中非常重要的一个文件因为它描述了gradle中可以运行的任务今天本文将会带大家体验一下如何创建一个build.gradle文件和如何编写其中的内容。
project和task
gradle是一个构建工具所谓构建工具就是通过既定的各种规则将原代码或者原文件通过一定的task处理过后打包生成目标文件的步骤。
所以我们在gradle中有两个非常重要的概念分别是项目和任务。
每一个gradle的构建任务可以包含一个或者多个项目项目可以有多种类型比如是一个web项目或者一个java lib项目等。为了实现project要完成的目标需要定义一个个的task来辅助完成目标。
task主要用来执行特定的任务比如编译class文件打包成jar生成javadoc等等。
在 Gradle 中两个顶级概念project项目和 task 任务
所有 Gradle 都有一个或多个 project 构成。project 的展现取决于 Gradle 所做的工作。举例。 project 可以是一个 JAR 库 或者是 web 应用。它可以是由项目生产 JAR 组成发布的 ZIP。一个 project 不一定 代表一个东西要构建。它可能是一件要做的事如将应用程序部署到工作台 或生产环境。如果这看起来有点模糊现在不要担心。Gradle 基于约定的构建支持增加一个 更具体的定义的 project。
每个项目都是由一个或多个 task。一个 task 代表了一个构建生成的原子的作品。这可能是编写一些类创建一个 JAR 生成 Javadoc或发布一些库。
现在我们将看看在构建一个 project 时定义一些简单的 task 。后面的章节将介绍多个 project 和更多的 task 。
Hello world
运行 Gradle 是使用 gradle 命令行。命令行会寻找项目的根目录下 build.gradle 的文件这个就是构建的脚本或者严格说是构建的配置脚本。他定义了project项目和 task 任务。
尝试输出创建一个 build.gradle 命名的文件
Example 6.1. Your first build script
build.gradle
task hello {doLast {println Hello world!}
}命令行切换到包含 build.gradle 文件的目录执行 gradle -q hello
实战一个例子
接下来我们使用一个具体的例子来讲解一下gradle到底是怎么用的。
首先我们创建一个新的project目录
$ mkdir gradle-test
$ cd gradle-testgradle提供了一个init方法来方便的创建gradle项目的骨架我们用下看
gradle init
Starting a Gradle Daemon (subsequent builds will be faster)Select type of project to generate:1: basic2: application3: library4: Gradle plugin
Enter selection (default: basic) [1..4] 2Select implementation language:1: C2: Groovy3: Java4: Kotlin5: Scala6: Swift
Enter selection (default: Java) [1..6] 3Split functionality across multiple subprojects?:1: no - only one application project2: yes - application and library projects
Enter selection (default: no - only one application project) [1..2] 1Select build script DSL:1: Groovy2: Kotlin
Enter selection (default: Groovy) [1..2] 1Select test framework:1: JUnit 42: TestNG3: Spock4: JUnit Jupiter
Enter selection (default: JUnit 4) [1..4] 1Project name (default: gradle-test):
Source package (default: gradle.test): Task :init
Get more help with your project: https://docs.gradle.org/6.7/samples/sample_building_java_applications.htmlBUILD SUCCESSFUL in 45s
2 actionable tasks: 2 executed按照你的需要经过一系列的选择之后就可以生成一个基本的gradle项目了。
我们看下生成的文件和目录
.
├── app
│ ├── build.gradle
│ └── src
│ ├── main
│ │ ├── java
│ │ │ └── gradle
│ │ │ └── test
│ │ │ └── App.java
│ │ └── resources
│ └── test
│ ├── java
│ │ └── gradle
│ │ └── test
│ │ └── AppTest.java
│ └── resources
├── gradle
│ └── wrapper
│ ├── gradle-wrapper.jar
│ └── gradle-wrapper.properties
├── gradlew
├── gradlew.bat
└── settings.gradle14 directories, 8 files其中gradle-wrapper是帮你自动设置和安装gradle的工具同时它还提供了gradlew和gradlew.bat这两个执行文件用来执行gradle的任务。
我们主要看其中的两个配置文件settings.gradle和build.gradle。
settings.gradle中配置的是gradle中要build的项目信息
rootProject.name gradle-test
include(app)上面的例子中rootProject.name指定了项目的名字include(‘app’)表示需要引入一个叫做app的子项目这个子项目中包含着实际的要打包的内容。
再看一下app中的build.gradle文件
plugins {// Apply the application plugin to add support for building a CLI application in Java.id application
}repositories {// Use JCenter for resolving dependencies.jcenter()
}dependencies {// Use JUnit test framework.testImplementation junit:junit:4.13// This dependency is used by the application.implementation com.google.guava:guava:29.0-jre
}application {// Define the main class for the application.mainClass gradle.test.App
}很简单指定了插件仓库地址依赖包和应用程序的main class路径。
一切准备好之后我们就可以进行构建和运行了。
有两种方式来运行一种方式就是使用系统自带的gradle命令一种方式就是使用刚刚gradle为你生成的gradlew。
gradle run Configure project :app
Repository ${repo.url} replaced by $REPOSITORY_URL . Task :app:run
Hello World!
gradle build Configure project :app
Repository ${repo.url} replaced by $REPOSITORY_URL .BUILD SUCCESSFUL in 2s
7 actionable tasks: 6 executed, 1 up-to-date你还可以带上 --scan 参数将build上传到gradle scan中得到更加详细的构建分析
./gradlew build --scanBUILD SUCCESSFUL in 0s
7 actionable tasks: 7 executedPublishing a build scan to scans.gradle.com requires accepting the Gradle Terms of Service defined at https://gradle.com/terms-of-service.
Do you accept these terms? [yes, no] yesGradle Terms of Service accepted.Publishing build scan...
https://gradle.com/s/5u4w3gxeurtd2task详细讲解
上面的例子中我们使用的都是gradle默认的tasks并没有看到自定义task的使用接下来我们将会探讨一下如何在build.gradle编写自己的task。
这里我们使用的groovy来编写build.gradle所以我们可以像运行代码一样来运行它。
task脚本
先创建一个非常简单的task
task hello {doLast {println Hello www.flydean.com!}
}上面定义了一个名叫hello的task并且会在执行最后输出 “Hello www.flydean.com!”。
我们这样运行
gradle -q hello
Hello www.flydean.com!-q的意思是悄悄的执行将会忽略gradle自身的log信息。我们把要执行的task名字写在gradle后面就可以了。
如果你熟悉ant命令的话可以看到gradle的task和ant很类似不过更加的强大。
因为是groovy脚本所以我们可以在其中执行代码
task upper {doLast {String someString www.flydean.comprintln Original: $someStringprintln Upper case: ${someString.toUpperCase()}}
}运行结果 gradle -q upper
Original: www.flydean.com
Upper case: WWW.FLYDEAN.COM或者执行times操作
task count {doLast {4.times { print $it }}
}gradle -q count
0 1 2 3task依赖
gradle中的一个task可以依赖其他的task
task hello {doLast {println Hello www.flydean.com!}
}
task intro {dependsOn hellodoLast {println Im flydean}
}上面两个task的顺序是无关的可以依赖的写在前面被依赖的写在后面或者反过来都成立。
动态task
除了静态的task之外我们还可以通过代码来动态创建task
4.times { counter -task task$counter {doLast {println Im task number $counter}}
}gradle -q task1
Im task number 1我们还可以将task看做成为一个对象调用gradle的api进行操作
4.times { counter -task task$counter {doLast {println Im task number $counter}}
}
task0.dependsOn task2, task3上面的例子中我们调用API手动创建了task之间的依赖关系 gradle -q task0
Im task number 2
Im task number 3
Im task number 0还可以task之间的属性调用
task myTask {ext.myProperty www.flydean.com
}task printTaskProperties {doLast {println myTask.myProperty}
}默认task
如果不想每次都在调用gradle命令的时候手动指定某个具体的task名字我们可以使用defaultTasks
defaultTasks clean, runtask clean {doLast {println Default Cleaning!}
}task run {doLast {println Default Running!}
}task other {doLast {println Im not a default task!}
}上面的代码执行gradle和gradle clean run是相当的。
build script的外部依赖
既然build script可以用groovy代码来编写那么如果我们想要在build script中使用外部的jar包怎么办呢
这个时候我们可以将外部依赖放到buildscript()方法中后面的task就可以使用引入的依赖了
import org.apache.commons.codec.binary.Base64buildscript {repositories {mavenCentral()}dependencies {classpath group: commons-codec, name: commons-codec, version: 1.2}
}task encode {doLast {def byte[] encodedString new Base64().encode(hello world\n.getBytes())println new String(encodedString)}
}上面的例子中encode使用了一个外部的依赖包Base64这个依赖包是在buildscript方法中引入的。
