执行任何 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) 中,针对基于 Java 的项目使用 Wrapper
$ 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 >>