執行任何 Gradle 建置的建議方式是使用 Gradle Wrapper。

gradle basic 2

Wrapper 指令碼會呼叫已宣告版本的 Gradle,並在必要時預先下載。

wrapper workflow

Wrapper 可用作 gradlewgradlew.bat 檔案。

Wrapper 提供以下好處

  • 將專案標準化在特定 Gradle 版本上。

  • 為不同使用者提供相同的 Gradle 版本。

  • 為不同執行環境(IDE、CI 伺服器等)提供 Gradle 版本。

使用 Gradle Wrapper

強烈建議使用 Wrapper 執行建置,以確保建置的執行可靠、受控且標準化。

根據作業系統,您執行 gradlewgradlew.bat,而不是 gradle 命令。

典型的 Gradle 呼叫

$ gradle build

要在 Linux 或 OSX 電腦上執行 Wrapper

$ ./gradlew build

要在 Windows PowerShell 上執行 Wrapper

$ .\gradlew.bat build

命令在 Wrapper 所在的目錄中執行。如果您要在不同的目錄中執行命令,則必須提供 Wrapper 的相對路徑

$ ../gradlew build

下列主控台輸出示範在 Windows 電腦上,在命令提示字元 (cmd) 中使用 Wrapper,針對 Java-based 專案

$ gradlew.bat build

Downloading https://services.gradle.org/distributions/gradle-5.0-all.zip
.....................................................................................
Unzipping C:\Documents and Settings\Claudia\.gradle\wrapper\dists\gradle-5.0-all\ac27o8rbd0ic8ih41or9l32mv\gradle-5.0-all.zip to C:\Documents and Settings\Claudia\.gradle\wrapper\dists\gradle-5.0-al\ac27o8rbd0ic8ih41or9l32mv
Set executable permissions for: C:\Documents and Settings\Claudia\.gradle\wrapper\dists\gradle-5.0-all\ac27o8rbd0ic8ih41or9l32mv\gradle-5.0\bin\gradle

BUILD SUCCESSFUL in 12s
1 actionable task: 1 executed

請參閱 Gradle Wrapper 參考 以進一步了解。

下一步: 了解 Gradle CLI >>