Gradle 安裝
如果您只想執行現有的 Gradle 專案,而且建置使用 Gradle Wrapper,則不需要安裝 Gradle。這可以通過專案根目錄中是否存在 gradlew
或 gradlew.bat
檔案來識別。
. (1) ├── gradle │ └── wrapper (2) ├── gradlew (3) ├── gradlew.bat (3) └── ⋮
1 | 專案根目錄。 |
2 | Gradle Wrapper (Gradle 包裝器). |
3 | 用於執行 Gradle 建置的腳本。 |
如果您的專案中已存在 gradlew
或 gradlew.bat
檔案,**您不需要安裝 Gradle**。但是您需要確保您的系統 滿足 Gradle 的先決條件。
如果您想更新專案的 Gradle 版本,可以按照 升級 Gradle 章節 中的步驟操作。請使用 Gradle Wrapper 升級 Gradle。
Android Studio 內建可運作的 Gradle 安裝,因此**僅在該 IDE 中工作時,您不需要另外安裝 Gradle**。
如果您不符合上述條件並決定在您的機器上安裝 Gradle,請先在終端機中執行 gradle -v
檢查是否已安裝 Gradle。如果命令沒有返回任何內容,則表示尚未安裝 Gradle,您可以按照以下說明進行操作。
您可以在 版本發布頁面 上找到所有 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
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 安裝
手動安裝
步驟 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