下载

提示

如无版本要求，选择最新版本即可，可自行选择 binary-only 或者 complete ，这里以 v8.2.1 版本为例，点击 complete 自动跳转下载。

• binary-only：仅二进制文件(不包含文档和源码)

• complete：完整的 , 包含文档和源码

访问 https://gradle.org/releases/ 打开如下页面 :

解压

注意

环境变量配置时需要指定包路径，若此路径进行调整，环境变量配置 需与调整路径保持一致 !!!

下载完成后进行解压 ，文中以解压到 D:\Develop Software 下为例，最终目录结构如下：

环境变量配置

提示

Windows 系统下打开环境变量配置界面方式有多种，这里不针对其他方式展开讨论。

打开环境变量配置

1. Win+R 打开运行窗口，输入如下命令，然后点击 确定 。

rundll32 sysdm.cpl,EditEnvironmentVariables

2. 打开如下界面后，点击 新建 系统变量

注意

注意区分 用户变量 和 系统变量，用户变量 下配置的所有变量，仅在当前登录账户下生效，如需要多个登录账户均生效，建议配置在系统变量下，系统变量属于全局变量，不受登录账户影响。

配置 GRADLE_HOME

变量名为GRADLE_HOME， 变量值为上文的解压路径，也可以点击 浏览目录 快速选择，最后点击 确定 保存。

配置 GRADLE_USER_HOME

同上，新增系统变量，变量名为 GRADLE_USER_HOME ，变量值可自行指定目录，这里我以 D:\Repository\Gradle 为例。

配置 PATH

1. 找到系统变量 Path。

2. 编辑 Path 变量，点击右上角新建 ，添加 %GRADLE_HOME%\bin 点击 确定 保存。

验证配置

配置完成后命令窗口输入如下命令，查看 gradle 版本

gradle -v

打印如下 ，说明配置成功。

------------------------------------------------------------
Gradle 8.2.1
------------------------------------------------------------

Build time:   2023-07-10 12:12:35 UTC
Revision:     a38ec64d3c4612da9083cc506a1ccb212afeecaa

Kotlin:       1.8.20
Groovy:       3.0.17
Ant:          Apache Ant(TM) version 1.10.13 compiled on January 4 2023
JVM:          1.8.0_381 (Oracle Corporation 25.381-b09)
OS:           Windows 11 10.0 amd64

优化配置

在上文的 GRADLE_USER_HOME 目录下创建 gradle.properties 文件，配置内容如下 :

# 开启守护进程 通过开启守护进程，下一次构建的时候，将会连接这个守护进程进行构建，而不是重新fork一个gradle构建进程
org.gradle.daemon=true
# 设置jvm内存大小
org.gradle.jvmargs=-Xmx5120m -XX:MaxPermSize=512m -XX:+HeapDumpOnOutOfMemoryError -Dfile.encoding=UTF-8
# 开启并行编译任务
org.gradle.parallel=true
# 开启 Gradle 缓存
org.gradle.caching = true
# 开启按需加载
org.gradle.configureondemand=true

如上同目录下，创建 init.gradle 文件，配置内容如下 :

配置代理仓库，提高依赖包下载速度。

allprojects {
	repositories {
		mavenLocal()
		maven { url 'https://maven.aliyun.com/repository/central' }
		maven { url 'https://maven.aliyun.com/repository/public' }
		maven { url 'https://maven.aliyun.com/repository/google' }
		maven { url 'https://maven.aliyun.com/repository/gradle-plugin' }
		maven { url 'https://maven.aliyun.com/repository/spring/' }
		mavenCentral()
	}
	buildscript {
		repositories {
			maven { url 'https://maven.aliyun.com/repository/central' }
			maven { url 'https://maven.aliyun.com/repository/public' }
			maven { url 'https://maven.aliyun.com/repository/google' }
			maven { url 'https://maven.aliyun.com/repository/gradle-plugin' }
			maven { url 'https://maven.aliyun.com/repository/spring/' }
		}
	}
	println "maven mirror injected !"
}