快捷導(dǎo)航

Java構(gòu)建工具Gradle的安裝和使用圖文教程

更新時間：2025年09月10日 10:23:37 作者：我是zxb

Gradle?是一個功能強大的構(gòu)建工具,支持自動化和定制化的構(gòu)建過程,下面這篇文章主要介紹了Java構(gòu)建工具Gradle的安裝和使用的相關(guān)資料,文中通過代碼介紹的非常詳細,需要的朋友可以參考下

Gradle簡介

Gradle 是一款 Google 推出的基于JVM、通用靈活的_項目構(gòu)建工具_，支持 Maven、JCenter 多種第三方倉庫，支持傳遞性依賴、廢棄了繁雜的 xml 文件，轉(zhuǎn)而使用簡潔的、支持多種語言（如：Java、groovy等）build腳本文件官網(wǎng)地址：https://gradle.org

為什么學習Gradle？

構(gòu)建速度更快
更現(xiàn)代

常用構(gòu)建工具

自動構(gòu)建工具對比	Ant	Maven	Gradle
構(gòu)建性能	最高	最低	居中
倉庫	開發(fā)者自己處理	maven倉庫	支持多種遠程倉庫
依賴管理	ivy管理	GAV坐標管理	GNV坐標管理
插件支持	實現(xiàn)方便	實現(xiàn)較難	實現(xiàn)發(fā)變組
遵循特定目錄結(jié)構(gòu)	NO	遵循	同maven
配置文件	xml文件最為繁瑣	xml文件	代碼腳本，便于編寫業(yè)務(wù)邏輯
側(cè)重點	小型項目構(gòu)建	項目包管理	大型項目構(gòu)建
目前地位	使用較少	目前主流	未來趨勢

Gradle安裝

1. 安裝JDK

JDK至少位1.8及以上

2. 下載Gradle并配置環(huán)境變量

https://gradle.org/install/

環(huán)境變量配置：

驗證

C:\Users\zxb>gradle -v

Welcome to Gradle 8.13!

Here are the highlights of this release:
 - Daemon JVM auto-provisioning
 - Enhancements for Scala plugin and JUnit testing
 - Improvements for build authors and plugin developers

For more details see https://docs.gradle.org/8.13/release-notes.html


------------------------------------------------------------
Gradle 8.13
------------------------------------------------------------

Build time:    2025-02-25 09:22:14 UTC
Revision:      073314332697ba45c16c0a0ce1891fa6794179ff

Kotlin:        2.0.21
Groovy:        3.0.22
Ant:           Apache Ant(TM) version 1.10.15 compiled on August 25 2024
Launcher JVM:  23.0.1 (Oracle Corporation 23.0.1+11-39)
Daemon JVM:    F:\env\Java\openjdk-23.0.1 (no JDK specified, using current Java home)
OS:            Windows 10 10.0 amd64

Gradle中的常用命令

常用命令說明：

常用gradle指令	作用`
gradle clean	清空build目錄
gradle classes	編譯業(yè)務(wù)代碼和配置文件
gradle test	編譯測試代碼，生成測試報告
gradle build	構(gòu)建項目
gradle build -x test	跳過測試構(gòu)建

需要注意的是：gradle 的指令要在含有 build.gradle 的目錄執(zhí)行。

修改maven下載源

Gradle自帶的 `maven` 源地址，該 Maven 源在國內(nèi)的訪問速度是很慢的，除非使用了特別的手段。一般情況下，建議使用第三方或者企業(yè)內(nèi)部的maven源

認識init.d文件夾

我們可以在 gradle 的 init.d 目錄下創(chuàng)建以.gradle 結(jié)尾的文件，.gradle 文件可以實現(xiàn)在 build 開始之前執(zhí)行，所以你可以在這個文件配置一些你想預(yù)先加載的操作。

在init.d文件夾創(chuàng)建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/' }
	}
}

測試需要等待正式啟動項目后

拓展1：啟用init.gradle的方法

1. 在命令行指定文件，例如：`gradle --init-script yourdir/init.gradle -q taskName` 你可以多次輸入此指令來指定多個init文件
2. 把init.gradle文件放到 `USER_HOME/.gradle` 目錄下
3. 把以.gradle結(jié)尾的問價放到 `USER_HOME/.gradle/init.d/` 目錄下
4. 把以.gradle結(jié)尾的文件放到 `GRADLE_HOME/init.d/` 目錄下

> 以上方法均可，gradle會安裝1-4的順序執(zhí)行這些腳本。

拓展2：倉庫地址說明

mavenLoacal()：指定使用maven本地倉庫，而本地倉庫在配置maven時settings文件指定倉庫位置。
- 如 E:\repository，gradle就會查jar包順序如下：
  1. USER_HOME/.m2/settings.xml
  2. M2_HOME/conf/setting.xml
  3. USER_HOME/.m2/repository
maven { url 地址 }：指定maven倉庫，一般用私有倉庫地址或者其它的第三方庫
mavenCentral()：這是Maven的中央倉庫，無需配置，直接聲明就能使用
~~jcenter()~~：JCenter中央倉庫，實際也是用的maven搭建的，但相比maven倉庫更友好，通過CDN分發(fā)，并且支持https訪問，在新版本中已經(jīng)廢除了，替換為mavenCentral()

gradle可以通過指定倉庫地址為本地maven倉庫地址和遠程倉庫地址相結(jié)合的方式，避免每次都從遠程倉庫下載依賴庫。

但是這種方式也有一定問題，如果本地maven倉庫中有這個依賴，就會直接加載本地依賴，如果本地倉庫沒有該依賴，那么還是會從遠程下載。但是下載的jar不是層次在本地maven倉庫中，而是放在自己的緩存文件中，默認在 USER_HOME/.gradle/caches。

訪問順序圖如下：

當然，你也可以通過配置 GRADLE_USER_HOME 環(huán)境變量，則會放在 GRADLE_USER_HOME/caches 目錄。但是這樣是無法將 gradle caches指向 maven repository。

進階技巧：優(yōu)化 Gradle 體驗

1. 加速依賴下載（換國內(nèi)鏡像）

編輯用戶目錄下的 ~/.gradle/init.gradle 文件（無則創(chuàng)建），添加阿里云鏡像：

allprojects {
    repositories {
        maven { url 'https://maven.aliyun.com/repository/public' }
        mavenCentral()
    }
}

讓依賴下載更快，解決 Maven 中央倉庫訪問慢問題。

2. 并行構(gòu)建提升速度

執(zhí)行構(gòu)建時添加 --parallel 參數(shù)：

gradle build --parallel

利用多線程并行執(zhí)行任務(wù)（如多模塊項目編譯），縮短構(gòu)建時間。

3. 集成 IDE 高效開發(fā)

IntelliJ IDEA/Android Studio：
打開 Gradle 項目時，IDE 自動識別 build.gradle ，點擊 “Sync” 按鈕同步依賴，也可通過右側(cè) Gradle 面板執(zhí)行任務(wù)。
VS Code：
安裝 Gradle for Java 插件，通過插件面板或終端執(zhí)行 Gradle 命令，實現(xiàn)代碼智能提示與構(gòu)建聯(lián)動。