命令行界面是在 IDE 外部与 Gradle 交互的主要方法。

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 参考

下一步: 了解 Settings 文件 >>