1. 什么是Gradle?
Gradle是一个开源的构建自动化工具,专注于灵活性和性能。 Gradle构建脚本使用Groovy或Kotlin DSL编写。 阅读Gradle功能,了解Gradle的功能。
- 高度可定制 - Gradle以一种可以以最基本的方式定制和扩展的方式建模。
- 快速 - Gradle通过重用先前执行的输出,仅处理已更改的输入以及并行执行任务来快速完成任务。
- 功能强大 - Gradle是Android的官方构建工具,并支持许多流行的语言和技术。
2. Gradle 的下载和安装
我们可以安装Gradle 构建工具在Linux,MacOS ,windows 操作系统上,这个文档覆盖了使用包管理器像SDKMAN!,Homebrew,或者Scoop的安装方法。
使用Gradle Wrapper是升级Gradle的推荐方法
我们可以找到所有的发布版本在发布页面
1.1 Gradle 必要条件
Gradle 可以运行在大多数的操作系统中,但是需要JDK 或者JRE 8 以上版本
检查方法,打开操作系统命令行终端,输入命令
java -version
执行成功如下所示:
注意:
Gradle附带了自己的Groovy库,因此不需要安装Groovy。 Gradle会忽略任何现有的Groovy安装。
Gradle 会在path环境变量中招JDK 安装路径,我们可以设置JAVA_HOME 环境变量指向所需JDK的安装目录
1.2 Gradle 安装
1.2.1 包管理器安装
SDKMAN! 是一个在大多数基于Unix的系统上管理多个软件开发工具包的并行版本的工具。
sdk install gradle
Homebrew是“macOS缺失包管理器”
brew install gradle
Scoop是一款受Homebrew启动的Windows命令行安装程序。
scoop install gradle
Chocolatey是“Windows的包管理器”。
choco install gradle
MacPorts是一个用于管理macOS上的工具的系统:
sudo port install gradle
1.2.2 手动安装
Download 下载最新的发布版本
当前最新版本是5.2.1 ,发布时间是2019年2月8日。发布的压缩包有两种。
The current Gradle release is version 5.2.1, released on 08 Feb 2019. The distribution zip file comes in two flavors:
- 二进制版本下载
- Binary-only
- 完整版本下载(包括二进制,文档,样例代码等)
- Complete, with docs and sources
1.3 配置环境变量
1.3.1 Linux or Mac OS
export PATH=$PATH:/opt/gradle/gradle-5.2./bin
1.3.2 Windows
新建环境变量
GRADLE_HOME C:\Users\xingyun\apps\gradle\gradle-5.2.-all\gradle-5.2.
追加到Path环境变量
%GRADLE_HOME%\bin\
1.4 验证安装
输入以下命令验证安装
gradle -v
验证成功输出如下所示:
1.5 创建新的Gradle构建
1.5.1 初始化一个项目
1. 打开命令行,在根目录下输入以下命令创建一个叫做 basic-demo 文件夹
mkdir basic-demo
2. 执行成功会显示如下:
3.进入创建的文件夹输入以下命令
cd basic-demo
4.执行成功如下所示:
5.输入gradle初始化命令
gradle init
6. 执行成功如下所示:
7.输入数字2后按下回车键
8.显示如下所示
9.这里选择脚本语言,我们选择groovy,因此输入1后按下回车键
10.执行成功后如下所示:
11.这里需要设置项目名称,我们保持默认即可,直接回车或者输入一个项目名称
12.我们可以看到已经生成成功了
13. 查看当前文件夹列表,输入命令
ls
14. 执行成功返回结果如下:
目录结构如下:
├── build.gradle
├── gradle
│ └── wrapper
│ ├── gradle-wrapper.jar
│ └── gradle-wrapper.properties
├── gradlew
├── gradlew.bat
└── settings.gradle
-
build.gradle
用于配置当前项目的Gradle构建脚本 -
gradle-wrapper.jar
Gradle Wrapper可执行JAR -
gradle-wrapper.properties
Gradle Wrapper配置属性 -
gradlew
基于Unix的系统的Gradle Wrapper脚本 -
gradlew.bat
适用于Windows的Gradle Wrapper脚本 -
settings.gradle
用于配置Gradle构建的Gradle设置脚本
1.5.2 创建一个task (任务)
Gradle提供API,用于通过基于Groovy或Kotlin的DSL创建和配置任务。 项目包括一组任务,每个任务执行一些基本操作。
Gradle附带了一个可以在您自己的项目中配置的任务库。 例如,有一种名为Copy的核心类型,它将文件从一个位置复制到另一个位置。 复制任务非常有用(有关详细信息,请参阅文档),但在此,再一次,让我们保持简单。 执行以下步骤:
1. 创建一个src 文件夹
2.在src目录中添加名为myfile.txt的文件。 内容是任意的(甚至可以是空的),但为方便起见,添加单行Hello,World! 它。
3. 在构建文件中定义一个名为Copy的类型的副本(注意大写字母),该任务将src目录复制到名为dest的新目录。 (您不必创建dest目录 - 任务将为您完成。)
build.gradle
task copy(type: Copy, group: "Custom", description: "Copies sources to the dest directory") {
from "src"
into "dest"
}
build.gradle.kts
tasks.create<Copy>("copy") {
description = "Copies sources to the dest directory"
group = "Custom" from("src")
into("dest")
}
在这里,group和description可以是您想要的任何内容。 您甚至可以省略它们,但这样做也会在以后使用的任务报告中省略它们。
这段脚本的功能是将src 文件夹下的所有内容都复制到dest 文件夹下,如果dest 文件夹不存在,则创建它。
4.执行新的copy任务
.\gradlew copy
打开dest 文件夹我们可以看到,src 文件夹下刚才创建的myfile.txt 已经复制进来了。
1.5.3 使用插件
使用插件语法将基本插件添加到构建脚本文件中。 请务必在文件顶部添加插件{}块。
plugins {
id "base"
}
Kotlin build.gradle.kts
plugins {
id("base")
}
现在添加一个从src目录创建zip存档的任务。
Groovy build.gradle
task zip(type: Zip, group: "Archive", description: "Archives sources in a zip file") {
from "src"
setArchiveName "basic-demo-1.0.zip"
}
Kotlin build.gradle.kts
tasks.create<Zip>("zip") {
description = "Archives sources in a zip file"
group = "Archive" from("src")
setArchiveName("basic-demo-1.0.zip")
}
基本插件使用设置在 build/distributions 文件夹中创建一个名为basic-demo-1.0.zip的存档文件。
在这种情况下,只需运行新的zip任务,
.\gradlew zip
执行成功如下会显示
并查看生成的zip文件是否在您期望的位置
1.5.3 探索并调试您的构建
让我们看看在我们的新项目中如何处理Gradle。对命令行接口的完整引用也可用。
1.5.3.1 发现可用任务
tasks命令列出了可以调用的渐变任务,包括由基本插件添加的任务,以及刚刚添加的自定义任务。
.\gradlew tasks
执行成功会显示:
1.5.4 分析和调试生成
Gradle还提供了一个丰富的基于Web的构建视图,称为buildscan
通过使用--scan选项或将构建扫描插件显式应用到项目中,您可以在link:scans.gradle.com免费创建一个构建扫描。将生成扫描发布到scans.gradle.com将此数据传输到gradle的服务器。要将数据保存在自己的服务器上,请查看Gradle Enterprise。
尝试通过在执行任务时添加--scan来创建生成扫描。
.\gradlew zip --scan
执行成功后如下所示:
打开网址:https://gradle.com/s/niiuxn3t6mogs
首次打开会有一个页面提示输入邮箱,输入后
邮箱可以看到如下所示:
点击Discover your build 后可以看到这样的管理界面
如果你浏览一下你的构建扫描,你应该能够很容易地发现在哪里执行了什么任务,花了多长时间,应用了哪些插件,等等。考虑下一次在*上调试某些内容时共享生成扫描。
1.5.5 发现可用属性
“属性”命令告诉您有关项目属性的信息。
.\gradlew properties
输出结果如下
详细内容可看:
> Task :properties ------------------------------------------------------------
Root project
------------------------------------------------------------ allprojects: [root project 'basic-demo']
ant: org.gradle.api.internal.project.DefaultAntBuilder@28d77beb
antBuilderFactory: org.gradle.api.internal.project.DefaultAntBuilderFactory@7e7a6637
application: C++ application 'main'
archivesBaseName: basic-demo
artifacts: org.gradle.api.internal.artifacts.dsl.DefaultArtifactHandler_Decorated@6ac031ac
asDynamicObject: DynamicObject for root project 'basic-demo'
baseClassLoaderScope: org.gradle.api.internal.initialization.DefaultClassLoaderScope@417a100d
buildDir: C:\Users\xingyun\Downloads\basic-demo\build
buildFile: C:\Users\xingyun\Downloads\basic-demo\build.gradle
buildPath: :
buildScriptSource: org.gradle.groovy.scripts.TextResourceScriptSource@526133ea
buildTypes: BuildType container
buildscript: org.gradle.api.internal.initialization.DefaultScriptHandler@7f87ac4f
childProjects: {}
class: class org.gradle.api.internal.project.DefaultProject_Decorated
classLoaderScope: org.gradle.api.internal.initialization.DefaultClassLoaderScope@1421af42
components: SoftwareComponentInternal set
configurationActions: org.gradle.configuration.project.DefaultProjectConfigurationActionContainer@54a2fb3
configurationTargetIdentifier: org.gradle.configuration.ConfigurationTargetIdentifier$@5eefa293
configurations: configuration container
convention: org.gradle.api.internal.plugins.DefaultConvention@1cc888d5
copy: task ':copy'
defaultArtifacts: org.gradle.api.internal.plugins.DefaultArtifactPublicationSet_Decorated@58a6fb1
defaultTasks: []
deferredProjectConfiguration: org.gradle.api.internal.project.DeferredProjectConfiguration@5169ef04
dependencies: org.gradle.api.internal.artifacts.dsl.dependencies.DefaultDependencyHandler_Decorated@
dependencyLocking: org.gradle.internal.locking.DefaultDependencyLockingHandler_Decorated@2ae79433
depth:
description: null
displayName: root project 'basic-demo'
distsDir: C:\Users\xingyun\Downloads\basic-demo\build\distributions
distsDirName: distributions
ext: org.gradle.internal.extensibility.DefaultExtraPropertiesExtension@7c468139
extensions: org.gradle.api.internal.plugins.DefaultConvention@1cc888d5
fileOperations: org.gradle.api.internal.file.DefaultFileOperations@62c9507a
fileResolver: org.gradle.api.internal.file.BaseDirFileResolver@19a7ed97
flavors: Flavor container
gradle: build 'basic-demo'
group:
identityPath: :
inheritedScope: org.gradle.internal.extensibility.ExtensibleDynamicObject$InheritedDynamicObject@ff7a49c
layout: org.gradle.api.internal.file.DefaultProjectLayout@47f0a312
libsDir: C:\Users\xingyun\Downloads\basic-demo\build\libs
libsDirName: libs
listenerBuildOperationDecorator: org.gradle.configuration.internal.DefaultListenerBuildOperationDecorator@6f126116
logger: org.gradle.internal.logging.slf4j.OutputEventListenerBackedLogger@49ffe236
logging: org.gradle.internal.logging.services.DefaultLoggingManager@7b9e6cd1
machines: org.gradle.nativeplatform.internal.DefaultTargetMachineFactory@39b4b883
modelRegistry: org.gradle.model.internal.registry.DefaultModelRegistry@45d26472
modelSchemaStore: org.gradle.model.internal.manage.schema.extract.DefaultModelSchemaStore@730ac0ac
module: org.gradle.api.internal.artifacts.ProjectBackedModule@5d3640ea
mutationState: project :
name: basic-demo
normalization: org.gradle.normalization.internal.DefaultInputNormalizationHandler_Decorated@7b7ac2f8
objects: org.gradle.api.internal.model.DefaultObjectFactory@67161db4
parent: null
parentIdentifier: null
path: :
platforms: Platform container
pluginManager: org.gradle.api.internal.plugins.DefaultPluginManager_Decorated@31b114d0
plugins: [org.gradle.buildinit.plugins.BuildInitPlugin@141bbdea, org.gradle.buildinit.plugins.WrapperPlugin@39dbc093, org.gradle.api.plugins.HelpTasksPlugin@6ef781a1, org.gradle.language.base.plugins.LifecycleBasePlugin@57591f3b, org.gradle.language.plugins.NativeBasePlugin@1ee40cd7, org.gradle.platform.base.plugins.ComponentBasePlugin@79dc88c0, org.gradle.language.base.plugins.LanguageBasePlugin@2b74e4d3, org.gradle.platform.base.plugins.BinaryBasePlugin@344b9641, org.gradle.language.base.plugins.ComponentModelBasePlugin@af7a6ab, org.gradle.nativeplatform.plugins.NativeComponentModelPlugin@1770b5bd, org.gradle.nativeplatform.plugins.NativeComponentPlugin@1b2e99fc, org.gradle.nativeplatform.toolchain.plugins.MicrosoftVisualCppCompilerPlugin@73bffd46, org.gradle.nativeplatform.toolchain.plugins.GccCompilerPlugin@44cacf64, org.gradle.nativeplatform.toolchain.plugins.ClangCompilerPlugin@5685571d, org.gradle.nativeplatform.toolchain.internal.plugins.StandardToolChainsPlugin@390bc548, org.gradle.language.cpp.plugins.CppBasePlugin@35d25ae2, org.gradle.language.cpp.plugins.CppApplicationPlugin@27f112d3, org.gradle.api.plugins.ReportingBasePlugin@5bb0948f, org.gradle.testing.base.plugins.TestingBasePlugin@3cf63b34, org.gradle.nativeplatform.test.plugins.NativeTestingBasePlugin@1bd47302, org.gradle.nativeplatform.test.cpp.plugins.CppUnitTestPlugin@341c9d21, org.gradle.api.plugins.BasePlugin@6bd773c1]
processOperations: org.gradle.api.internal.file.DefaultFileOperations@62c9507a
project: root project 'basic-demo'
projectConfigurator: org.gradle.api.internal.project.BuildOperationCrossProjectConfigurator@6675ca14
projectDir: C:\Users\xingyun\Downloads\basic-demo
projectEvaluationBroadcaster: ProjectEvaluationListener broadcast
projectEvaluator: org.gradle.configuration.project.LifecycleProjectEvaluator@5e81f9bb
projectPath: :
projectRegistry: org.gradle.api.internal.project.DefaultProjectRegistry@e2492df
properties: {...}
providers: org.gradle.api.internal.provider.DefaultProviderFactory@5ebda1a1
publicType: org.gradle.api.plugins.BasePluginConvention
reporting: org.gradle.api.reporting.ReportingExtension_Decorated@16d0f508
repositories: repository container
resourceLoader: org.gradle.internal.resource.transfer.DefaultUriTextResourceLoader@47cd8a48
resources: org.gradle.api.internal.resources.DefaultResourceHandler@6d554a04
rootDir: C:\Users\xingyun\Downloads\basic-demo
rootProject: root project 'basic-demo'
script: false
scriptHandlerFactory: org.gradle.api.internal.initialization.DefaultScriptHandlerFactory@5ed64ea6
scriptPluginFactory: org.gradle.configuration.ScriptPluginFactorySelector@4fbf98c1
serviceRegistryFactory: org.gradle.internal.service.scopes.ProjectScopeServices$@648bd4b4
services: ProjectScopeServices
standardOutputCapture: org.gradle.internal.logging.services.DefaultLoggingManager@7b9e6cd1
state: project state 'EXECUTED'
status: integration
subprojects: []
tasks: task set
toolChains: NativeToolChain container
unitTest: C++ test suite 'test'
version: unspecified
zip: task ':zip' BUILD SUCCESSFUL in 1s
actionable task: executed
PS C:\Users\xingyun\downloads\basic-demo>
默认情况下,项目名称与文件夹名称匹配。您还可以指定group和version属性,但目前它们采用的是默认值,如描述所示。
buildFile 属性是生成脚本的完全限定路径名,默认情况下,它位于projectdir-中。
您可以更改许多属性。例如,您可以尝试将以下行添加到构建脚本文件中,然后重新执行 .\gradlew properties
description = "A trivial Gradle build"
version = "1.0"