Gradle 安裝

如果您只想執行現有的 Gradle 專案,而且建置使用 Gradle Wrapper,則不需要安裝 Gradle。這可以通過專案根目錄中是否存在 gradlewgradlew.bat 檔案來識別。

.   (1)
├── gradle
│   └── wrapper (2)
├── gradlew         (3)
├── gradlew.bat     (3)
└── ⋮
1 專案根目錄。
2 Gradle Wrapper (Gradle 包裝器).
3 用於執行 Gradle 建置的腳本。

如果您的專案中已存在 gradlewgradlew.bat 檔案,**您不需要安裝 Gradle**。但是您需要確保您的系統 滿足 Gradle 的先決條件

如果您想更新專案的 Gradle 版本,可以按照 升級 Gradle 章節 中的步驟操作。請使用 Gradle Wrapper 升級 Gradle。

Android Studio 內建可運作的 Gradle 安裝,因此**僅在該 IDE 中工作時,您不需要另外安裝 Gradle**。

如果您不符合上述條件並決定在您的機器上安裝 Gradle,請先在終端機中執行 gradle -v 檢查是否已安裝 Gradle。如果命令沒有返回任何內容,則表示尚未安裝 Gradle,您可以按照以下說明進行操作。

您可以在 Linux、macOS 或 Windows 上安裝 Gradle 建置工具。安裝可以手動完成,也可以使用套件管理器,例如 SDKMAN!Homebrew

您可以在 版本發布頁面 上找到所有 Gradle 版本發布及其校驗和。

先決條件

Gradle 在所有主要作業系統上運行。它需要 Java Development Kit (JDK) 版本 8 或更高版本才能運行。您可以查看 相容性矩陣 以獲取更多資訊。

若要檢查,請執行 java -version

❯ java -version
openjdk version "11.0.18" 2023-01-17
OpenJDK Runtime Environment Homebrew (build 11.0.18+0)
OpenJDK 64-Bit Server VM Homebrew (build 11.0.18+0, mixed mode)

Gradle 使用在您的路徑中找到的 JDK、您的 IDE 使用的 JDK,或您的專案指定的 JDK。在此範例中,$PATH 指向 JDK17

❯ echo $PATH
/opt/homebrew/opt/openjdk@17/bin

您還可以設定 JAVA_HOME 環境變數以指向特定的 JDK 安裝目錄。當安裝了多個 JDK 時,這特別有用

❯ echo %JAVA_HOME%
C:\Program Files\Java\jdk1.7.0_80
❯ echo $JAVA_HOME
/Library/Java/JavaVirtualMachines/jdk-16.jdk/Contents/Home

Gradle 支援 KotlinGroovy 作為主要的建置語言。Gradle 自帶 Kotlin 和 Groovy 函式庫,因此它們不需要安裝。Gradle 會忽略現有的安裝。

Linux 安裝

使用套件管理器安裝

SDKMAN! 是一個用於在大多數類 Unix 系統(macOS、Linux、Cygwin、Solaris 和 FreeBSD)上管理多個軟體開發套件並行版本的工具。Gradle 由 SDKMAN! 部署和維護。

❯ sdk install gradle

其他套件管理器也可用,但它們發布的 Gradle 版本不受 Gradle, Inc. 控制。Linux 套件管理器可能會發布修改版的 Gradle,與官方版本相比,它可能不相容或不完整。

手動安裝

步驟 1 - 下載 最新的 Gradle 發行版本

發行版本 ZIP 檔案有兩種格式:

  • 僅二進制 (bin)

  • 完整 (all),包含文件和原始碼

我們建議下載 bin 檔案;它是一個較小的檔案,下載速度更快(而且最新的文件可在線上取得)。

步驟 2 - 解壓縮發行版本

將發行版本 zip 檔案解壓縮到您選擇的目錄,例如:

❯ mkdir /opt/gradle
❯ unzip -d /opt/gradle gradle-8.13-bin.zip
❯ ls /opt/gradle/gradle-8.13
LICENSE  NOTICE  bin  README  init.d  lib  media

步驟 3 - 配置您的系統環境

若要安裝 Gradle,解壓縮檔案的路徑需要位於您的 Path 中。配置您的 PATH 環境變數,以包含解壓縮發行版本的 bin 目錄,例如:

❯ export PATH=$PATH:/opt/gradle/gradle-8.13/bin

或者,您也可以新增環境變數 GRADLE_HOME 並將其指向解壓縮的發行版本。您可以將 $GRADLE_HOME/bin 新增到您的 PATH,而不是將特定版本的 Gradle 新增到您的 PATH。當升級到不同版本的 Gradle 時,只需變更 GRADLE_HOME 環境變數即可。

export GRADLE_HOME=/opt/gradle/gradle-8.13
export PATH=${GRADLE_HOME}/bin:${PATH}

macOS 安裝

使用套件管理器安裝

SDKMAN! 是一個用於在大多數類 Unix 系統(macOS、Linux、Cygwin、Solaris 和 FreeBSD)上管理多個軟體開發套件並行版本的工具。Gradle 由 SDKMAN! 部署和維護。

❯ sdk install gradle

使用 Homebrew

❯ brew install gradle

使用 MacPorts

❯ sudo port install gradle

其他套件管理器也可用,但它們發布的 Gradle 版本不受 Gradle, Inc. 控制。

手動安裝

步驟 1 - 下載 最新的 Gradle 發行版本

發行版本 ZIP 檔案有兩種格式:

  • 僅二進制 (bin)

  • 完整 (all),包含文件和原始碼

我們建議下載 bin 檔案;它是一個較小的檔案,下載速度更快(而且最新的文件可在線上取得)。

步驟 2 - 解壓縮發行版本

將發行版本 zip 檔案解壓縮到您選擇的目錄,例如:

❯ mkdir /usr/local/gradle
❯ unzip gradle-8.13-bin.zip -d /usr/local/gradle
❯ ls /usr/local/gradle/gradle-8.13
LICENSE	NOTICE	README	bin	init.d	lib

步驟 3 - 配置您的系統環境

若要安裝 Gradle,解壓縮檔案的路徑需要位於您的 Path 中。配置您的 PATH 環境變數,以包含解壓縮發行版本的 bin 目錄,例如:

❯ export PATH=$PATH:/usr/local/gradle/gradle-8.13/bin

或者,您也可以新增環境變數 GRADLE_HOME 並將其指向解壓縮的發行版本。您可以將 $GRADLE_HOME/bin 新增到您的 PATH,而不是將特定版本的 Gradle 新增到您的 PATH。當升級到不同版本的 Gradle 時,只需變更 GRADLE_HOME 環境變數即可。

建議編輯您主目錄中的 .bash_profile 以新增 GRADLE_HOME 變數

export GRADLE_HOME=/usr/local/gradle/gradle-8.13
export PATH=$GRADLE_HOME/bin:$PATH

Windows 安裝

手動安裝

步驟 1 - 下載 最新的 Gradle 發行版本

發行版本 ZIP 檔案有兩種格式:

  • 僅二進制 (bin)

  • 完整 (all),包含文件和原始碼

我們建議下載 bin 檔案。

步驟 2 - 解壓縮發行版本

使用 **檔案總管** 建立一個新的目錄 C:\Gradle

開啟第二個 **檔案總管** 視窗,並前往 Gradle 發行版本下載的目錄。雙擊 ZIP 封存檔以顯示內容。將內容資料夾 gradle-8.13 拖曳到您新建立的 C:\Gradle 資料夾。

或者,您可以使用您選擇的封存工具將 Gradle 發行版本 ZIP 解壓縮到 C:\Gradle

步驟 3 - 配置您的系統環境

若要安裝 Gradle,解壓縮檔案的路徑需要位於您的 Path 中。

在 **檔案總管** 中,右鍵點擊 本機 (或 電腦) 圖示,然後點擊 內容進階系統設定環境變數

系統變數 下,選取 Path,然後點擊 編輯。新增 C:\Gradle\gradle-8.13\bin 的項目。點擊 確定 以儲存。

或者,您可以新增環境變數 GRADLE_HOME 並將其指向解壓縮的發行版本。您可以將 %GRADLE_HOME%\bin 新增到您的 Path,而不是將特定版本的 Gradle 新增到您的 Path。當升級到不同版本的 Gradle 時,只需變更 GRADLE_HOME 環境變數即可。

驗證安裝

開啟主控台(或 Windows 命令提示字元),然後執行 gradle -v 以執行 gradle 並顯示版本,例如:

❯ gradle -v

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

Build time:    2024-06-17 18:10:00 UTC
Revision:      6028379bb5a8512d0b2c1be6403543b79825ef08

Kotlin:        1.9.23
Groovy:        3.0.21
Ant:           Apache Ant(TM) version 1.10.13 compiled on January 4 2023
Launcher JVM:  11.0.23 (Eclipse Adoptium 11.0.23+9)
Daemon JVM:    /Library/Java/JavaVirtualMachines/temurin-11.jdk/Contents/Home (no JDK specified, using current Java home)
OS:            Mac OS X 14.5 aarch64

您可以通過下載 SHA-256 檔案(可從 版本發布頁面 取得)並按照這些 驗證說明 驗證 Gradle 發行版本的完整性。