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

老子叫甜甜 提交于 2021-02-15 20:25:54

 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:

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"

 

易学教程内所有资源均来自网络或用户发布的内容,如有违反法律规定的内容欢迎反馈
该文章没有解决你所遇到的问题?点击提问,说说你的问题,让更多的人一起探讨吧!