命令行界面是与 Gradle 交互的主要方法，不包括 IDE。

gradle basic 2

Gradle CLI 是从终端与 Gradle 构建交互的主要方式。您可以使用它来运行任务、检查构建、管理依赖项和控制日志记录，所有这些都通过灵活而强大的命令行选项实现。

强烈建议使用Gradle Wrapper。在以下示例中，将 `gradle` 替换为 `./gradlew`（在 macOS / Linux 中）或 `gradlew.bat`（在 Windows 中）。

运行命令

要执行 Gradle 命令，请使用以下简单结构

gradle [taskName...] [--option-name...]

您可以指定一个或多个任务，用空格分隔。

gradle [taskName1 taskName2...] [--option-name...]

例如，要运行名为 `build` 的任务，只需输入

gradle build

首先 `clean`，然后 `build`

gradle clean build

命令行选项

Gradle 命令可以包含各种选项来调整其行为。选项可以出现在任务名称 之前 或 之后，如下所示

gradle [--option-name...] [taskName...]

对于接受值的选项，请使用等号（`=`）以提高清晰度

gradle [...] --console=plain

有些选项是切换开关，并且具有相反的形式。例如，要启用或禁用构建缓存

gradle build --build-cache
gradle build --no-build-cache

Gradle 还提供短选项等效项以方便使用。以下两个命令是等效的

gradle --help
gradle -h

执行任务

在 Gradle 中，任务属于特定的项目。为了清楚地指明要运行哪个任务，尤其是在多项目构建中，请使用冒号（`:`）作为项目分隔符。

要在根项目级别执行名为 `test` 的任务，请使用

gradle :test

对于嵌套子项目，请使用冒号指定完整路径

gradle :subproject:test

如果您运行一个不带任何冒号的任务，Gradle 会在当前目录的项目上下文中执行该任务

gradle test

任务选项

某些任务接受其自己的特定选项。在任务名称之后直接传递这些选项，并加上前缀 `--`。

以下是传递自定义选项的方法

gradle taskName --exampleOption=exampleValue

有关更多详细信息，请参阅完整的Gradle CLI 参考。

下一步：了解设置文件 >>