【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:$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、切换镜像源

      在 Gradle 的安装目录下，有个 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/' }
              }
          }
      }
      

      jar包查找顺序：${USER_HOME}/.m2/settings.xml >> ${M2_HOME}/conf/ settings.xml >> USER_HOME/.m2/repository

      • mavenLocal()： 指定使用maven本地仓库，而本地仓库在配置maven时settings文件指定的仓库位置。
      • 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插件，环境版本适配