The gradle command has the following usage:
gradle
[option...] [task...]
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
or on
. Default value is
on
. See Section 14.6, “Caching”.
-D
, --system-prop
Sets a system property of the JVM, for example -Dmyprop=myvalue
.
See Section 14.2, “Gradle properties and system properties”.
-I
, --init-script
Specifies an initialization script. See Chapter 53, Initialization Scripts.
-P
, --project-prop
Sets a project property of the root project, for example
-Pmyprop=myvalue
. See Section 14.2, “Gradle properties and system properties”.
-S
, --full-stacktrace
Print out the full (very verbose) stacktrace for any exceptions. See Chapter 19, Logging.
-a
, --no-rebuild
Do not rebuild project dependencies.
--all
Shows additional detail in the task listing. See Section 11.5.2, “Listing tasks”.
-b
, --build-file
Specifies the build file. See Section 11.4, “Selecting which build to execute”.
-c
, --settings-file
Specifies the settings file.
-d
, --debug
Log in debug mode (includes normal stacktrace). See Chapter 19, Logging.
-e
, --embedded
Specify an embedded build script.
-g
, --gradle-user-home
Specifies the Gradle user home directory. The default is the .gradle
directory in the user's home directory.
--gui
Launches the Gradle GUI. See Chapter 12, Using the Gradle Graphical User Interface.
-i
, --info
Set log level to info. See Chapter 19, Logging.
-m
, --dry-run
Runs the build with all task actions disabled. See Section 11.6, “Dry Run”.
--no-color
Do not use color in the console output.
-p
, --project-dir
Specifies the start directory for Gradle. Defaults to current directory. See Section 11.4, “Selecting which build to execute”.
--profile
Profiles build execution time and generates a report in the
directory. See Section 11.5.5, “Profiling a build”.
buildDir
/reports/profile
--project-cache-dir
Specifies the project-specific cache directory. Default value is .gradle
in the root project directory. See Section 14.6, “Caching”.
-q
, --quiet
Log errors only. See Chapter 19, Logging.
-s
, --stacktrace
Print out the stacktrace also for user exceptions (e.g. compile error). See Chapter 19, Logging.
-u
, --no-search-upwards
Don't search in parent directories for a settings.gradle
file.
-v
, --version
Prints version info.
-x
, --exclude-task
Specifies a task to be excluded from execution. See Section 11.2, “Excluding tasks”.
--continue
Continues task execution after a task failure.
The above information is printed to the console when you execute gradle -h
.
The following options are deprecated and will be removed in a future version of Gradle:
-n
, --dependencies
(deprecated) Show list of all project dependencies. You should use gradle dependencies
instead. See Section 11.5.3, “Listing project dependencies”.
-r
, --properties
(deprecated) Show list of all available project properties. You should use gradle properties
instead. See Section 11.5.4, “Listing project properties”.
-t
, --tasks
(deprecated) Show list of available tasks. You should use gradle tasks
instead. See Section 11.5.2, “Listing tasks”.
The Chapter 13, The Gradle Daemon contains more information about the daemon.
For example it includes information how to turn on the daemon by default
so that you can avoid using --daemon
all the time.
--daemon
Uses the Gradle daemon to run the build. Starts the daemon if not running or existing daemon busy. Chapter 13, The Gradle Daemon contains more detailed information when new daemon processes are started.
--foreground
Starts the Gradle daemon in the foreground. Useful for debugging or troubleshooting because you can easily monitor the build execution.
--no-daemon
Do not use the Gradle daemon to run the build. Useful occasionally if you have configured gradle to always run with the daemon by default.
--stop
Stops the Gradle daemon if it is running.
You can only stop daemons that were started with
the gradle version you use when running --stop
.
The following system properties are available for the gradle command. Note that command-line options take precedence over system properties.
gradle.user.home
Specifies the Gradle user home directory.
The Section 15.1, “Configuring the build environment via gradle.properties” contains specific information about gradle configuration available via system properties.
The following environment variables are available for the gradle command. Note that command-line options and system properties take precedence over environment variables.
GRADLE_OPTS
Specifies command-line arguments to use to start the JVM. This can be useful for setting
the system properties to use for running Gradle. For example you could set GRADLE_OPTS="-Dorg.gradle.daemon=true"
to use the Gradle daemon without needing to use the --daemon
option every time you
run Gradle. Section 15.1, “Configuring the build environment via gradle.properties” contains more information about ways of configuring the daemon
without using environmental variables, e.g. in more maintainable and explicit way.
GRADLE_USER_HOME
Specifies the Gradle user home directory.