【Mac】安装Gradle

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:$PATHzs@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
  

第一次使用Gradle加载项目会下载较多资源，比较慢，请耐心等待

5、Gradle升级

查看所有可能的警告信息：

$ gradle help --warning-mode=all

升级：

$ gradle wrapper --gradle-version 8.3

9、资料

• 【Gradle】mac环境安装Gradle及配置
• 通过gradle开发idea插件，环境版本适配