Gradle 的下载安装配置以及创建第一个Gradle 项目

 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.1/bin

1.3.2 Windows 

 新建环境变量

GRADLE_HOME

C:\Users\xingyun\apps\gradle\gradle-5.2.1-all\gradle-5.2.1

追加到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 使用插件

Gradle包含一系列插件，Gradle插件门户网站上提供了许多插件。 该发行版附带的插件之一是base 插件。 结合名为Zip的核心类型，您可以使用配置的名称和位置创建项目的zip存档。

使用插件语法将基本插件添加到构建脚本文件中。 请务必在文件顶部添加插件{}块。

 

Groovy build.gradle

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 后可以看到这样的管理界面

如果你浏览一下你的构建扫描，你应该能够很容易地发现在哪里执行了什么任务，花了多长时间，应用了哪些插件，等等。考虑下一次在StackOverflow上调试某些内容时共享生成扫描。

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$1@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@72313480
dependencyLocking: org.gradle.internal.locking.DefaultDependencyLockingHandler_Decorated@2ae79433
depth: 0
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$4@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
1 actionable task: 1 executed
PS C:\Users\xingyun\downloads\basic-demo>

View Code

默认情况下，项目名称与文件夹名称匹配。您还可以指定group和version属性，但目前它们采用的是默认值，如描述所示。

buildFile 属性是生成脚本的完全限定路径名，默认情况下，它位于projectdir-中。

您可以更改许多属性。例如，您可以尝试将以下行添加到构建脚本文件中，然后重新执行 .\gradlew properties

description = "A trivial Gradle build"
version = "1.0"