Fully hand-held tutorial on setting up the Java environment to a usable state as quickly as possible. Only knowledge of using the terminal is expected. This tutorial will be completely self-contained (excluding links to downloads).
For more detailed tutorials, see General Development Environment Setup Guide
Ubuntu
(in progress)
Java
Open a terminal and run
sudo apt install openjdk-17-jdk openjdk-17-doc openjdk-17-source
Gradle
IDE
Windows
Git
Install Git. Use the 64-bit standalone installer
This will be used for all terminal interactions on Windows. Access by searching for Git Bash on the windows search.
Hereby, "open a terminal" will refer to launching git bash.
Java
We use Java 17.
- Go to the Oracle download page and download the MSI installer:
This will download Java to the folder (or as appropriate for the version)
C:\Program Files\Java\jdk-17.0.3.1
- (The java path variable is already set. No action is needed)
- Double-check that java is installed properly:
Open a terminal and type in:
java -version
Something like the following should be outputted:
java version "17.0.3.1" 2022-04-22 LTS Java(TM) SE Runtime Environment (build 17.0.3.1+2-LTS-6) Java HotSpot(TM) 64-Bit Server VM (build 17.0.3.1+2-LTS-6, mixed mode, sharing)
Gradle
We are currently on Gradle 7. We will install it manually for ease of understanding. The official guide is here for reference. (Aside: we do not use the Gradle Wrapper)
- Download the latest Gradle 7 distribution (7.4.2 as of writing).
- Choose the complete version.
- Remember where you downloaded it.
Unpack Gradle (the following are excerpted from the gradle website)
- 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-7.4.2
to your newly createdC:\Gradle
folder.
- Create a new directory
Configure Gradle
- In File Explorer right-click on the
This PC
(orComputer
) icon, then clickProperties
->Advanced System Settings
->Environmental Variables
. - Under
System Variables
selectPath
, then clickEdit
. Add an entry forC:\Gradle\gradle-7.4.2\bin
. Click OK to save.
- In File Explorer right-click on the
Verify 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 7.4.2 ------------------------------------------------------------