Appendix D. Gradle Command Line 命令行

gradle 命令行用法如下:

  1. gradle [option...] [task...]

现存的命令行选项如下:

-?, -h, —help：
用于显示帮助信息

-a, —no-rebuild：不要重新编译依赖

—all：在任务列表中显示附加的详细信息，见 11.6.2, “Listing tasks”.

-b, —build-file：指定构建文件，见 Section 11.5, “Selecting which build to execute”.

-c, —settings-file：指定配置文件

—console：指定控制台输出产生哪种类型,plain 是生成普通的文本，该选项禁止所有颜色和富文本输出； auto (默认)当构建程序与控制台相关联时启动 颜色和富文本输出，或者不关联时生成普通文本；rich 启动颜色和富文本输出，忽略构建程序是否关联了控制台,如果没有关联构建输出将输出 ANSI 控制字符来生产富文本输出

—continue：任务失败时继续执行任务

—configure-on-demand (incubating)：只有相关的项目都配置在此构建中运行。这意味着为大型多项目拥有更快的构建，见 Section 57.1.1.1, “Configuration on demand”.

-D, —system-prop：设置 JVM 的系统属性, 如 -Dmyprop=myvalue. See Section 14.2, “Gradle properties and system properties”.

-d, —debug：记录在 debug 模式(包含平常的 stacktrace). See Chapter 18, Logging.

-g, —gradle-user-home：指定 Gradle 的用户目录，默认是在home 目录

—gui：启动 Gradle GUI. 见 Chapter 12, Using the Gradle Graphical User Interface.

-I, —init-script：指定初始化的脚本，见 Chapter 61, Initialization Scripts.

-i, —info：设置日志的信息级别，见Chapter 18, Logging.

-m, —dry-run：运行构建，所有任务的动作都禁止，见 Section 11.7, “Dry Run”.

—offline：指定构建操作不访问网络资源，见 Section 51.9.2, “Command line options to override caching”.

-P, —project-prop：设置 根项目的项目属性，如 -Pmyprop=myvalue，见 Section 14.2, “Gradle properties and system properties”.

-p, —project-dir：指定 Gradle 的启动目录，默认是当前目录，见 Section 11.5, “Selecting which build to execute”.

—parallel (incubating)：并行构建项目， Gradle 尝试确定用来使用的执行程序线程的最佳数量。只在解耦项目中使用此选项(见 Section 57.9, “Decoupled Projects”).

—parallel-threads (incubating)：并行构建项目，执行线程数量，如 —parallel-threads=3。只在解耦项目中使用此选项(见 Section 57.9, “Decoupled Projects”).

—profile：
描述执行时间并生成报告在 buildDir/reports/profile 目录，见 Section 11.6.7, “Profiling a build”.

—project-cache-dir：执行 project-specific 的缓冲目录，默认是在 .gradle 所在根项目目录，见 Section 14.6, “Caching”.

-q, —quiet：只记录错误，见 Chapter 18, Logging.

—recompile-scripts：
指定被缓存的构建脚本跳过，被迫重新编译。见 Section 14.6, “Caching”.

—refresh-dependencies：更新依赖的状态，见 Section 51.9.2, “Command line options to override caching”.

—rerun-tasks：指定忽略任意任务优化
Specifies that any task optimization is ignored.

-S, —full-stacktrace：打印全部异常（非常详细） stacktrace 消息，见 Chapter 18, Logging.

-s, —stacktrace：也打印出用户异常 (e.g. 编译错误). 见 Chapter 18, Logging.

-u, —no-search-upwards：不要再父目录寻找 settings.gradle 文件

-v, —version：打印版本信息

-x, —exclude-task：指定要排除的执行的任务，见 Section 11.2, “Excluding tasks”.

当你执行 gradle -h 上述信息将会打印到控制台

D.1. 过时的命令行选项

—no-color：不要使用颜色。这个命令替换为 —console plain 选项

D.2. DAEMON 命令行选项

Chapter 19, Gradle Daemon 包含了很多信息关于 daemon，来避免使用 —daemon

—daemon：
使用 Gradle daemon 来构建，当 daemon 未运行或者现存的daemon太繁忙时，可以启动 daemon ，详见 Chapter 19

—foreground：
在前景中启动 Gradle daemon ，在debug 或 troubleshooting时有用，可以轻松监控构建执行

—no-daemon：
不使用 Gradle daemon

—stop：
停止运行的 Gradle daemon

D.3. 系统属性

以下系统属性可用于 gradle 命令。请注意，命令行选项优先于系统属性。

gradle.user.home：执行 Gradle user用户目录

将 Section 20.1, “Configuring the build environment via gradle.properties”

D.4. 环境变量

GRADLE_OPTS：
指定用于启动 JVM 命令行参数。这可以是用于设置系统属性。例如，你可以设置 GRADLE_OPTS=”-Dorg.gradle.daemon=true” 使用 Gradle daemon 而无需每次运行 Gradle daemon 时都要使用—daemon 选项。

GRADLE_USER_HOME：
指定 Gradle 用户 home 目录 (默认是 “USER_HOME/.gradle” )

JAVA_HOME：
指定 JDK 安装目录