nil's blog

提示

如无版本要求，选择最新版本即可，根据需求选择对应的包类型，对应如下：

binary-only：仅二进制文件(不包含文档和源码)，下载包名为：gradle-x.x-bin.zip
complete：完整的 , 包含文档和源码，下载包名为：gradle-x.x-all.zip

下载

访问下载页面： https://gradle.org/releases ，以完整版为例，点击 complete 进行下载，若下载较慢可参考镜像加速下载方式。

下载加速镜像源

因下载源为 Github，偶尔会出现下载链接无法访问的情况，可以通过国内镜像源进行下载，注意区分版本与包类型，安装包类型可参考上面的包名对应，如完整版为：gradle-x.x-all.zip 。

腾讯云镜像源：https://mirrors.cloud.tencent.com/gradle/
华为云镜像源：https://mirrors.huaweicloud.com/gradle/
南京大学镜像源：https://mirror.nju.edu.cn/gradle

安装配置

下载完成后，将压缩包解压，以解压到 D:\Develop Software 下为例，最终目录结构如下：

Win+R 打开运行窗口，输入如下命令，然后点击 确定 打开环境变量配置。

shell

rundll32 sysdm.cpl,EditEnvironmentVariables

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

注意

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

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

配置 GRADLE_USER_HOME ，同上新增系统变量，变量值可自行指定目录，以 D:\Repository\Gradle 为例，如下：

找到系统变量 Path

编辑 Path 变量，点击右上角新建 ，添加 %GRADLE_HOME%\bin 逐级点击 确定 保存。然后进行配置验证。

验证配置

配置完成后，打开命令窗口，输入如下命令，查看版本信息：

gradle -v

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

Welcome to Gradle 8.5!

Here are the highlights of this release:
 - Support for running on Java 21
 - Faster first use with Kotlin DSL
 - Improved error and warning messages

For more details see https://docs.gradle.org/8.5/release-notes.html


------------------------------------------------------------
Gradle 8.5
------------------------------------------------------------

Build time:   2023-11-29 14:08:57 UTC
Revision:     28aca86a7180baa17117e0e5ba01d8ea9feca598

Kotlin:       1.9.20
Groovy:       3.0.17
Ant:          Apache Ant(TM) version 1.10.13 compiled on January 4 2023
JVM:          11.0.21 (Oracle Corporation 11.0.21+9-LTS-193)
OS:           Windows 11 10.0 amd64

优化配置

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

yaml

# 开启守护进程，下一次构建的时候，将会连接这个守护进程构建，而不是重新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 文件，配置内容如下 :

全局配置依赖下载镜像，提高下载速度。

groovy

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 !"
}

下载 ​

安装配置 ​

验证配置 ​

优化配置 ​

下载

安装配置

验证配置

优化配置