【Mac】安装Gradle

news2024/12/4 16:35:45

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 文件

配置环境变量：

zs@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

查看版本：
```
gradle -v
```

2.2 使用 homebrew 来安装Gradle

brew install gradle

2.3 通过程序编译安装

在没有安装gradle的情况下，用idea打开gradle项目会自动编译安装，默认会根据项目的 gradle-wrapper.properties 中的配置下载

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，将下边内容拷贝进去。

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