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

For more detailed tutorials, see General Development Environment Setup Guide

Table of Contents


Ubuntu

(in progress)

Java

Open a terminal and run

...

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

    • Open a terminal

    • 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
    $ sudo mkdir /opt/gradle
    $ sudo unzip -d /opt/gradle gradle-7.4.2-all.zip
  • Add to path

  • 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\
    Excerpt
    Code Block
    $ echo 'export PATH=$PATH:/opt/gradle/gradle-7.4.2
    \bin. Click OK to save.
    /bin' >> ~/.bashrc 



  • 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 a gradle.properties file in C:/Users/useryour user Home directory, ~/.gradle/gradle.properties
    • Copy/paste below into the file

      Code Block
      org.gradle.java.home=C:/Program Files/Java/jdk-17.0.3.1
      org.gradle.jvmargs=-Xmx4g

...

    • =TODO
      org.gradle.jvmargs=-Xmx4g

IDE

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

Eclipse

full guide: Eclipse IDE

Intellij

full guide: IntelliJ IDEA

  • Download IntelliJ Community. 
    • https://www.jetbrains.com/idea/download/#section=linux
    • Open a terminal and cd into the folder where you downloaded the tar file
    • Extract the file and move it to /opt/ (reference excerpt)

      Code Block
      $ tar -xzf ideaIC-2021.3.2.tar.gz
      $ sudo mv idea-IC-213.6777.52/ /opt/.
      $ ln -s /opt/idea-IC-213.6777.52/ /opt/idea
      $ sudo ln -s /opt/idea/bin/idea.sh /usr/local/bin/idea
      
      
  • Now you will need to configure IntelliJ to the Java environment you installed.

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

...

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

Eclipse

full guide: Eclipse IDE

Intellij

full guide: IntelliJ IDEA

...