Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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).

...

Code Block
sudo apt install openjdk-17-jdk openjdk-17-doc openjdk-17-source

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)

    • cd into the directory where you downloaded Gradle. Then


      Excerpt
      • Unzip the distribution zip file in the directory of your choosing, e.g.:
      Code Block
      $ mkdir /opt/gradle
      $ unzip -d /opt/gradle gradle-7.4.2-all.zip

  • Add to path

    Excerpt
    • 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:\Gradle\gradle-7.4.2\bin. Click OK to save.
  • Verify installation

    Excerpt
    • Open a console (or a Windows command prompt) and run gradle -v to run gradle and display the version, e.g.:
    Code Block
    $ gradle -v
    
    ------------------------------------------------------------
    Gradle 7.4.2
    ------------------------------------------------------------
  • Configure for IHMC software
    • excerpt from Gradle#Installation
    • create gradle.properties file in C:/Users/user/.gradle/gradle.properties
    • Copy/paste
    • Code Block
      org.gradle.java.home=C:/Program Files/Java/jdk-17.0.3.1
      org.gradle.jvmargs=-Xmx4g

IDE


Windows

Git

...

  • 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)

    Excerpt
    • 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 created C:\Gradle folder.
  • Add to path

    Excerpt
    • 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:\Gradle\gradle-7.4.2\bin. Click OK to save.
  • Verify installation

    Excerpt

    Open a console (or a Windows command prompt) and run gradle -v to run gradle and display the version, e.g.:

    Code Block
    $ gradle -v
    
    ------------------------------------------------------------
    Gradle 7.4.2
    ------------------------------------------------------------
  • Configure for IHMC software
    • excerpt from Gradle#Installation
    • create gradle.properties file in C:/Users/user/.gradle/gradle.properties
    • Copy/paste
    • Code Block
      org.gradle.java.home=C:/Program Files/Java/jdk-17.0.3.1
      org.gradle.jvmargs=-Xmx4g

Import Repositories

Don't forget the long paths thing

IDE

Choose your favorite IDE. I like intellij because it was the first IDE I arbitrarily chose to use.

...