项目 & 任务
Gradle 的一切都是基于项目和任务的。
构建由一个或多个项目组成。项目的概念很抽象,它取决于你要用Gradle 做什么 。项目可以是 一个 Jar 库或者一个 web 程序。也可以是一个 zip 压缩包,也可以是将项目部署到生产环境等等;
一个项目是由一个或多个任务组成的;任务是构建工作的原子单位,最小的工作单元。例如:编译字节码,创建 jar 。
Hello World
创建一个简单的任务,输出 Hello World!.
Groovy
task hello{
doLast {
println 'Hello World.'
}
}
Kotlin
tasks.register("hello"){
doLast {
println ("Hello World.")
}
}
输入命令 运行该任务
gradle hello
创建一个简单的构建
新建一个目录
使用 init 命令创建构建项目
Gradle 现在支持两种--Kotlin DSL 和 Groovy DSL .默认是 基于Groovy的,如果要使用 Kotlin 可以 使用 --dsl kotlin
gradle init --dsl kotlin
会生成如下目录
其中 .gitigonre 是 git 忽略文件;.gradle 是 gradle 的一些信息。
需要我们关注的是下面这些文件
├── cradle
│ └── wrapper
│ ├── gradle-wrapper.jar
│ └── gradle-wrapper.properties
├── build.gradle.kts
├── gradlew
├── gradlew.bat
└── settings.gradle.kts
- warpper 是 Gradle Wrapper 使用的目录
- gradle-wrapper.jar 是执行 Gradle Wrapper 使用的
- gradle-wrapper.properties 是 配置 Gradle Wrapper 属性的
- build.gradle.kts 用于配置当前项目的Gradle构建脚本
- gradlew 是 Unix 机器上的 执行脚本
- gradlew.bat 是 window 上的执行脚本
- settings.gradle.kts 是 用于配置Gradle构建的Gradle设置脚本
创建任务
Gradle提供了通过Groovy或基于kotlin的DSL创建和配置任务的api。项目包含一组任务,每个任务执行一些基本操作。
Gradle提供了一个任务库,我们可以在自己的项目中配置这些任务。例如,有一个核心类型的 Copy 任务,它可以复制文件。
下面我们就配置这个 任务来使用一下。
创建一个目录 src
在 src 下创建一个文件名称任意,例如 myFile.txt。添加任意内容,例如 Hello World!
在 配置脚本(build.gradle.kts) 添加 一个 Copy 类型的 copy 任务,从 src 目录复制到 dest 目录
Gradle 在执行时会自动创建 dest 目录。
Kotlin
tasks.register<Copy>("copy"){
description = "Copies sources to the dest directory"
group = "Custom"
from("src")
into("dest")
}
Groovy
task copy(type: Copy, group: "Custom", description: "Copies sources to the dest directory") {
from "src"
into "dest"
}
description 和 group 都是可选的,可以随便你定义;也是可以省略的;
执行 copy 任务
gradle copy
检查里面的 myFile.txt 是否复制完成。
使用插件
Gradle 提供了大量的插件,在 Gradle 插件站 可以查到
今天使用 一个 base 插件 结合它的核心类型 Zip 任务,实现打包压缩包的任务。
使用 base 插件
Kotlin
plugins {
id("base")
}
... rest of the build file ...
Groovy
plugins {
id "base"
}
... rest of the build file ...
创建一个 zip 任务,扩展自 核心类型 Zip
Kotlin
tasks.create<Zip>("zip") {
description = "Archives sources in a zip file"
group = "Archive"
from("src")
setArchiveName("basic-demo-1.0.zip")
}
Groovy
task zip(type: Zip, group: "Archive", description: "Archives sources in a zip file") {
from "src"
setArchiveName "basic-demo-1.0.zip"
}
执行 zip
gradle zip
至此,一个简单的构建完成了。
分析构建过程
Gradle 提供了一个基于 web的构建视图——构建扫描
在执行时 使用 --scan 选项或者明确使用构建扫描插件都可以免费的在 https://scans.gradle.com 创建一个扫描视图分析
gradle zip --scan
在同一服务条款后会直接发送到 构建扫描的平台,复制下面的连接打开即可。
打开之后会有详细的项目构建分析
End