1、说明
Gradle 运行依赖 JVM,需要先安装JDK,Gradle 与 JDK的版本对应参见:Java Compatibility
IDEA的版本也是有要求Gradle版本的,二者版本对应关系参见:Third-Party Software and Licenses
本次 Gradle 安装版本为 8.11.1,要求JDK8及以上的版本。
未安装JDK的移步:【Java】Linux、Mac、Windows 安装 Oracle JDK
2、安装
2.1 手动安装
-
下载 Gradle(若无研究源码等其他需求,下载binary即可):
-
解压下载的
.zip
文件 -
配置环境变量:
bashzs@Mac ~ % vim .zshrc # GRADLE_USER_HOME 为可选项,用于配置仓库地址,可选择与maven同一个仓库 export GRADLE_USER_HOME=/Users/zs/App/repository export GRADLE_HOME=/Users/zs/App/gradle-8.11.1 export PATH=$GRADLE_HOME/bin:$PATH zs@Mac ~ % source .zshrc
-
查看版本:
bashgradle -v
2.2 使用 homebrew 来安装Gradle
bash
brew install gradle
2.3 通过程序编译安装
在没有安装gradle的情况下,用idea打开gradle项目会自动编译安装,默认会根据项目的 gradle-wrapper.properties
中的配置下载
bash
distributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists
distributionUrl=https\://services.gradle.org/distributions/gradle-8.3-bin.zip
zipStoreBase=GRADLE_USER_HOME
zipStorePath=wrapper/dists
参数说明:
- distributionBase:下载的 Gradle 压缩包解压后存储的主目录。GRADLE_USER_HOME为环境变量,如果没配置,则默认是用户目录下的.gradle文件夹。
- distributionPath:相对于 distributionBase的解压后的 Gradle压缩包的路径
- zipStoreBase:同 distributionBase,只不过是存放 zip压缩包的
- zipStorePath:同 distributionPath,只不过是存放 zip压缩包的
- distributionUrl:Gradle发行版压缩包的下载地址。
services.gradle.org
未必能访问到,可修改地址为https://mirrors.cloud.tencent.com/gradle/gradle-8.3-bin.zip
,gradle版本可自行指定。
3、切换镜像源
在 ./Users/zs/App/gradle-8.11.1/init.d
目录下新建文件 init.gradle
,将下边内容拷贝进去。
bash
allprojects {
repositories {
mavenLocal()
maven { name "Alibaba" ; url "https://maven.aliyun.com/repository/public" }
maven { name "Bstek" ; url "https://nexus.bsdn.org/content/groups/public/" }
mavenCentral()
}
buildscript {
repositories {
maven { name "Alibaba" ; url 'https://maven.aliyun.com/repository/public' }
maven { name "Bstek" ; url 'https://nexus.bsdn.org/content/groups/public/' }
maven { name "M2" ; url 'https://plugins.gradle.org/m2/' }
}
}
}
- mavenLocal(): 指定使用maven本地仓库,而本地仓库在配置maven时settings文件指定的仓库位置。
jar包查找顺序:${USER_HOME}/.m2/settings.xml
>>${M2_HOME}/conf/ settings.xml
>>USER_HOME/.m2/repository
- maven {url 地址}:指定maven仓库,一般用私有仓库地址或其它的第三方库【比如阿里镜像仓库地址】。
- mavenCentral():Maven的中央仓库,无需配置,直接声明就可以使用。
- jcenter():JCeater 中央仓库,实际也是用maven搭建的,但相比Maven仓库更友好,通过CDN分发,并且支持https访问。在新版本中已经废弃了,替换为了mavenCentral()。
Gradle 可以通过指定仓库地址为本地maven仓库地址和远程仓库地址相结合的方式,避免每次都会去远程仓库下载依赖库。
这种方式也有一定的问题,如果本地maven仓库有这个依赖,就会从直接加载本地依赖,如果本地仓库没有该依赖,那么还是会从远程下载。但是下载的jar不是存储在本地maven仓库中,而是放在自己的缓存目录中,默认在${USER_HOME}/.guade/caches
目录,当然如果我们配置过GRADLE_USER_HOME
环境变量,则会放在GRADLE_USER_HOME/caches
目录。
gadle caches 无法指向 maven repository,因为 caches 下载的文件不是按照maven仓库中存放的方式。
4、IDEA 集成 Gradle
- 第一步,
IntelliJ IDEA ⇒ Settings ⇒ Plugins ⇒ MarketPlace
,输入 gradle,点击install
,安装完成后重启IDE
- 第二步,
File ⇒ New Projects Setup ⇒ Settings for New Projects ⇒ Buil, Execution, Deployment ⇒ Build Tools ⇒ Gradle
,将Distribution
切换为Local installation
第一次使用Gradle加载项目会下载较多资源,比较慢,请耐心等待
5、Gradle升级
查看所有可能的警告信息:
bash
$ gradle help --warning-mode=all
升级:
bash
$ gradle wrapper --gradle-version 8.3