Appendix B. Gradle Command Line

The gradle command has the following usage:

gradle [option...] [task-name...]

The command-line options available for the gradle command are listed below:

-?, -h, --help

Shows a help message.

-C, --cache

Specifies how compiled build scripts should be cached. Possible values are: rebuild, off, on. Default value is on. See Section 11.4, “Caching” for more details.

-D, --system-prop

Sets a system property of the JVM, for example -Dmyprop=myvalue.

-I, --init-script

Specifies an initialization script. See Chapter 35, Initialization Scripts for details.

-K, --default-import-file

Specifies the default import file.

-P, --project-prop

Sets a project property of the root project, for example -Pmyprop=myvalue.

-S, --full-stacktrace

Print out the full (very verbose) stacktrace for any exceptions. See Chapter 15, Logging.

-a, --no-rebuild

Do not rebuild project dependencies.

-b, --build-file

Specifies the build file.

-c, --settings-file

Specifies the settings file.

-d, --debug

Log in debug mode (includes normal stacktrace). See Chapter 15, Logging.

-e, --embedded

Specify an embedded build script.

-g, --gradle-user-home

Specifies the Gradle user home directory.

--gui

Launches a GUI application. See Chapter 10, Using the Gradle Graphical User Interface.

-i, --info

Set log level to info. See Chapter 15, Logging.

-l, --plugin-properties-file

Specifies the plugin properties file.

-m, --dry-run

Runs the build with all task actions disabled.

-n, --dependencies

Show list of all project dependencies.

--no-imports

Disable usage of default imports for build script files. See Section C.3, “Using Gradle without IDE support” for details.

-p, --project-dir

Specifies the start directory for Gradle. Defaults to current directory.

-q, --quiet

Log errors only. See Chapter 15, Logging.

-r, --properties

Show list of all available project properties.

-s, --stacktrace

Print out the stacktrace also for user exceptions (e.g. compile error). See Chapter 15, Logging.

-t, --tasks

Show list of all available tasks and their dependencies.

-u, --no-search-upwards

Don't search in parent folders for a settings.gradle file.

-v, --version

Prints version info.

-x, --exclude-task

Specifies a task to be excluded from execution.

The same information is printed to the console when you execute gradle -h.