• Appendix D. Gradle Command Line 命令行
    • D.1. 过时的命令行选项
    • D.2. DAEMON 命令行选项
    • D.3. 系统属性
    • D.4. 环境变量

    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 安装目录