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

  • 配置环境变量:

    bash 复制代码
    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
  • 查看版本:

    bash 复制代码
    gradle -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

9、资料

相关推荐
UnicornDev19 小时前
从零开始学iOS开发(第四十四篇):App Store 提交与审核 —— 让应用走向世界
macos·objective-c·cocoa
晴天无痕21 小时前
intel过来的xcode项目在M芯片电脑无法显示模拟器的问题日
ide·macos·xcode
Digitally1 天前
如何连接安卓手机到 Mac?2026 年 7 种可靠方法
android·macos·智能手机
Digitally1 天前
如何将短信从 iPhone 传输到 Mac?
macos·ios·iphone
timebeign1 天前
Claude安装流程,系统macOS m1
macos
一块小土坷垃1 天前
App Cleaner & Uninstaller 9.1.1 – macOS 专业级应用程序清理与卸载工具
macos·开源软件
七七powerful1 天前
mac电脑安装cmca根证书
java·前端·macos
Front思1 天前
安卓证书申请 + iOS 证书申请(含 Windows 无 Mac 方案)+ HBuilderX 云打包配置
android·macos·ios
云天AI实战派1 天前
ChatGPT/AI 智能体问题排查指南:Mac Agent、语音 API、推理性能全流程修复手册
人工智能·macos·chatgpt
2601_958320572 天前
【详细版教程】Windows/macOS/Linux 安装 OpenClaw 2.6.6 指南(包含安装包)
linux·运维·windows·macos·小龙虾·open claw一键安装