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

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

Wrapper 可用作 gradlew
或 gradlew.bat
檔案。
Wrapper 提供以下好處
-
將專案標準化在特定 Gradle 版本上。
-
為不同使用者提供相同的 Gradle 版本。
-
為不同執行環境(IDE、CI 伺服器等)提供 Gradle 版本。
使用 Gradle Wrapper
強烈建議使用 Wrapper 執行建置,以確保建置的執行可靠、受控且標準化。
根據作業系統,您執行 gradlew
或 gradlew.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 >>