Installation
The current Gradle release is 4.10.2. You can download binaries and view docs for all Gradle versions from the releases page.
- Prerequisites
- Additional resources
- Install
- Install with a package manager
- Install manually
- Upgrade with the Gradle Wrapper
- Older Releases
- Command-Line Completion
Prerequisites
Gradle runs on all major operating systems and requires only a Java JDK or JRE version 7 or higher to be installed. To check, run java -version
:
$ java -version
java version "1.8.0_121"
Additional resources
- On-demand and live online training is available for free to Gradle users.
- Self-paced tutorials are a good place to try Gradle with a variety of languages in addition to the docs.
- Gradle has a new visual build inspection tool called build scans.
- Finally, the Gradle Newsletter is a great way to keep
UP-TO-DATE
, with issues crafted monthly.
Install
Install with a package manager
SDKMAN! is a tool for managing parallel versions of multiple Software Development Kits on most Unix-based systems.
代码语言:javascript复制$ sdk install gradle 4.10.2
Homebrew is “the missing package manager for macOS”.
代码语言:javascript复制$ brew install gradle
Scoop is a command-line installer for Windows inspired by Homebrew.
代码语言:javascript复制$ scoop install gradle
Chocolatey is “the package manager for Windows”.
代码语言:javascript复制$ choco install gradle
MacPorts is a system for managing tools on macOS:
代码语言:javascript复制$ sudo port install gradle
› Additional helpful information
Install manually
Step 1. Download the latest Gradle distribution
The current Gradle release is version 4.10.2, released on 19 Sep 2018. The distribution zip file comes in two flavors:
- Binary-only
- Complete, with docs and sources
If in doubt, choose the binary-only version and browse docs and sources online.
Need to work with an older version? See the releases page.
Step 2. Unpack the distribution
Linux & MacOS users
Unzip the distribution zip file in the directory of your choosing, e.g.:
代码语言:javascript复制$ mkdir /opt/gradle
$ unzip -d /opt/gradle gradle-4.10.2-bin.zip
$ ls /opt/gradle/gradle-4.10.2
LICENSE NOTICE bin getting-started.html init.d lib media
Microsoft Windows users
Create a new directory C:Gradle
with File Explorer.
Open a second File Explorer window and go to the directory where the Gradle distribution was downloaded. Double-click the ZIP archive to expose the content. Drag the content folder gradle-4.10.2
to your newly created C:Gradle
folder.
Alternatively you can unpack the Gradle distribution ZIP into C:Gradle
using an archiver tool of your choice.
Step 3. Configure your system environment
Linux & MacOS users
Configure your PATH
environment variable to include the bin
directory of the unzipped distribution, e.g.:
$ export PATH=$PATH:/opt/gradle/gradle-4.10.2/bin
Microsoft Windows users
In File Explorer right-click on the This PC
(or Computer
) icon, then click Properties
-> Advanced System Settings
-> Environmental Variables
.
Under System Variables
select Path
, then click Edit
. Add an entry for C:Gradlegradle-4.10.2bin
. Click OK to save.
Step 4. Verify your installation
Open a console (or a Windows command prompt) and run gradle -v
to run gradle and display the version, e.g.:
$ gradle -v
------------------------------------------------------------
Gradle 4.10.2
------------------------------------------------------------
› Additional helpful information
Upgrade with the Gradle Wrapper
If your existing Gradle-based build uses the Gradle Wrapper, you can easily upgrade by running the wrapper
task, specifying the desired Gradle version:
$ ./gradlew wrapper --gradle-version=4.10.2 --distribution-type=bin
Note that it is not necessary for Gradle to be installed to use the Gradle wrapper. The next invocation of gradlew
or gradlew.bat
will download and cache the specified version of Gradle.
$ ./gradlew tasks
Downloading https://services.gradle.org/distributions/gradle-4.10.2-bin.zip
...
› Additional helpful information
Older Releases
You can find all releases and their checksums on the releases page.
Command-Line Completion
Command-line completion scripts are available for bash and zsh. This provides completion for Gradle tasks and command-line options.