Gradle 透過建置腳本中的資訊,自動化軟體的建置、測試和部署。

gradle basic 1

Gradle 核心概念

專案

Gradle 專案是可以建置的軟體組件,例如應用程式或函式庫。

單一專案建置包含一個稱為根專案的專案。

多專案建置包含一個根專案和任意數量的子專案。

建置腳本

建置腳本詳細說明 Gradle 應採取哪些步驟來建置專案。

每個專案可以包含一個或多個建置腳本。

相依性管理

相依性管理是一種自動化技術,用於宣告和解析專案所需的外部資源。

每個專案通常包含許多外部相依性,Gradle 將在建置期間解析這些相依性。

任務

任務是基本的工作單元,例如編譯程式碼或執行測試。

每個專案包含一個或多個在建置腳本或插件內定義的任務。

插件

插件用於擴展 Gradle 的功能,並可選擇性地為專案貢獻任務。

Gradle 專案結構

許多開發人員將首次透過現有專案與 Gradle 互動。

在專案根目錄中存在 gradlew 和 gradlew.bat 檔案,清楚地表明正在使用 Gradle。

Gradle 專案結構如下

project
├── gradle                              (1)
│   ├── libs.versions.toml              (2)
│   └── wrapper
│       ├── gradle-wrapper.jar
│       └── gradle-wrapper.properties
├── gradlew                             (3)
├── gradlew.bat                         (3)
├── settings.gradle(.kts)               (4)
├── subproject-a
│   ├── build.gradle(.kts)              (5)
│   └── src                             (6)
└── subproject-b
    ├── build.gradle(.kts)              (5)
    └── src                             (6)
1 Gradle 目錄,用於儲存 Wrapper 檔案等。
2 用於相依性管理的 Gradle 版本目錄
3 Gradle Wrapper 腳本
4 Gradle 設定檔,用於定義根專案名稱和子專案。
5 兩個子專案(subproject-a 和 subproject-b)的 Gradle 建置腳本
6 專案的原始碼和/或其他檔案

呼叫 Gradle

IDE

Gradle 內建於許多 IDE 中,包括 Android Studio、IntelliJ IDEA、Visual Studio Code、Eclipse 和 NetBeans。

當您在 IDE 中建置、清理或執行應用程式時,可以自動呼叫 Gradle。

建議您查閱您選擇的 IDE 手冊,以了解更多關於如何使用和配置 Gradle 的資訊。

命令列

安裝後,可以在命令列中呼叫 Gradle。例如

$ gradle build
大多數專案不使用已安裝的 Gradle 版本。

Gradle Wrapper

Wrapper 是一個腳本,用於呼叫宣告的 Gradle 版本,並且是執行 Gradle 建置的建議方式。它位於專案根目錄中,作為 gradlew 或 gradlew.bat 檔案。

$ gradlew build     // Linux or OSX
$ gradlew.bat build  // Windows

下一步: 了解 Gradle Wrapper >>