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

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 文件 >>