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.jarGradle Wrapper可执行JARgradle-wrapper.propertiesGradle 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 后可以看到这样的管理界面
如果你浏览一下你的构建扫描，你应该能够很容易地发现在哪里执行了什么任务，花了多长时间，应用了哪些插件，等等。考虑下一次在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>
默认情况下，项目名称与文件夹名称匹配。您还可以指定group和version属性，但目前它们采用的是默认值，如描述所示。
buildFile 属性是生成脚本的完全限定路径名，默认情况下，它位于projectdir-中。
您可以更改许多属性。例如，您可以尝试将以下行添加到构建脚本文件中，然后重新执行 .\gradlew properties
description = "A trivial Gradle build" version = "1.0"
