Gradle CLI 介绍
- Gradle 命令行工具用法:
Gradle [Option...] [Tasks...]
可以看出Gradle CLI就是告诉Gradle如何执行预定义的任务的工具,是面向Task的界面。
其中Task大体上分为两种:
1.探索类Task,即帮助Task;
2.构建设置Task,这种Task完成构建的预设置;
3.构建Task,完成构建的Task;
option可以完成配置输入的工作,即构建的配置信息可以通过CLI提供(当然也可以写成配置文件)。其中不需要提供值得option可以被组合使用,例如-i -q <=> -iq
下面将分别介绍tasks 和 options
探索类task
- dependencies
列出项目的依赖,包括传递性依赖。 - dependencyInsight
解释在依赖图中一个依赖如何被选择,为什么会被选择。检查一个特定的依赖,需要提供--dependency
参数。
检查compile以来以外的依赖时使用--configuration
参数。
使用例子:dependencyInsight --denpendency apache-commons
- help
显示Gradle CLI最基本的用法,如果运行gradle命令而没有指定task,则help 被自动执行。 - projects
显示在多项目构架中的所有子项目,单项目构建没有子项目。 - properties
列出项目中所有可用的属性,有些属性是由Gradle的project对象提供的。other properties是由用户自定义的属性,可能来自于属性文件、属性命令行选项、直接在构建脚本中定义。 - tasks
显示项目中所有可运行的task,包括他们的描述信息。项目的插件也会提供额外的task。可以使用--all
来显示task的附加信息。 - buildEnviroment
显示root project的构建脚本的依赖 - components
显示该项目的所有的component - dependentComponents
显示该项目所有components的dependent components - model
显示项目配置的model
构建设置task
- init
- wrapper
命令行选项
最重要的命令行选项如下:
- -?,h,-help:打印出所有可用的命令行选项,包括描述信息
- -b,--build-file:Gradle构建脚本的默认名字为build.gradle,使用这个命令行选项可以执行一个特定名字的构建脚本,如:
gradle -b test.gradle
- --offline:通常,构建生命中的依赖必须在离线仓库中存在才可以使用,使用这个选项可以以离线模式运行构建
- --daemon:执行tasks时启动Gradle守护进程。在使用Gradle重复运行构建时,每一次初始化一个构建时,JVM都要启动一次,Gradle的依赖要在入到类的加载器中,还要建立项目对象模型,而守护进程以后台进程方式运行Gradle,一旦启动,Gradle命令就会在后续的构建中重用之前创建的守护进程,避免启动时造成的开销,停止守护进程命令:
gradle --stop
- --no-daemon:执行tasks时不使用守护进程
更多的命令行选项
Gradle CLI官方文档