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

Panel

Table of Contents

Ubuntu

...

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

    Code Block
    $ echo 'export PATH=$PATH:/opt/gradle/gradle-7.4.2/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 Create a gradle.properties file in your user Home directory, ~/.gradle/gradle.properties
    • Copy/paste below into the file

      Code Block
      org.gradle.java.home=/usr/lib/jvm/java-17-openjdk-amd64
      org.gradle.jvmargs=-Xmx4g

IDE

Choose your favorite IDE. I like intellij because it was the first IDE I arbitrarily chose to useThis guide currently only contains instructions for IntelliJ. We are working on Eclipse.

Eclipse

full Full guide: Eclipse IDE

Intellij

full 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

    • Multiexcerpt include
      MultiExcerptNameUbuntu Get IntelliJ
      PageWithExcerptIntelliJ IDEA
    • Intellij is now installed and runnable from the command line 

      Code Block
      $ idea
      
    • To create a desktop entry, open IntelliJ once and select Tools > Create Desktop Entry
  • Now you will need to configure IntelliJ to the Java environment you installed.

...

  • 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

...