Page Comparison

We currently run Java 17.

JDK Installation

Ubuntu

OpenJDK

...

This is the default method for Ubuntu and is recommended:recommended JDK to install.

OpenJDK

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

SDKMAN!

See the page on SDKMAN!

Now install Java:

sdk install java 17.0.3-zulu

Note, the JDK will be installed in a hidden folder located at (You may have to press Ctrl + H to view hidden folders in Ubuntu's file explorer):

~/.sdkman/candidates/java/17.0.3-zulu

Jetbrains Runtime

The Jetbrains runtime (customized JDK) is an option for installing on Linux. It provides font rendering fixes. Read more here.

Manual Azul Zulu JDK

Manually install Azul's Zulu JDK:

$ curl -sL https://cdn.azul.com/zulu/bin/zulu17.34.19-ca-jdk17.0.3-linux_x64.tar.gz -o zulu.tar.gz
$ tar -xvzf zulu.tar.gz
# mv zulu17.34.19-ca-jdk17.0.3-linux_x64/ /opt/.
# rm /opt/zulu
# ln -s /opt/zulu17.34.19-ca-jdk17.0.3-linux_x64/ /opt/zulu

Windows

Azul is providing JDK 17 with JavaFX as part of their community Zulu distribution. You may also reference the official Zulu Installation Guide including the Installation on Windows Using the Zulu ZIP File page.

1. Visit https://www.azul.com/downloads/zulu-community/?architecture=x86-64-bit&package=jdk-fx
2. Under Zulu Community Downloads, select:
   1. Java Version: Java 17 (LTS)
   2. Operating System: Windows
   3. Java Package: JDK FX (if not already selected)
3. Download the zip distribution and extract the contents to a temporary folder
4. Move the extracted folder to something like C:\Program Files\Zulu\zulu17.34.19-ca-fx-jdk17.0.3-win_x64
5. In Windows > System Properties > Environment Variables
   
   1. Append the bin directory of the JDK to the PATH variable (i.e PATH=<other_stuff>;C:\Program Files\Zulu\zulu17.34.19-ca-fx-jdk17.0.3-win_x64\bin)
   2. Under System Variables, set JAVA_HOME to the JDK directory (i.e JAVA_HOME=;C:\Program Files\Zulu\zulu17.34.19-ca-fx-jdk17.0.3-win_x64). Move it to the top of the list if you have multiple versions
6. Make sure you configure your IDE settings to reference this JDK. There will probably be 2 references - the Java compiler and the gradle compiler
7. (Optional) Open a new console and check that java -version prints something like the following

java -version
openjdk version "17.0.3" 2022-04-19 LTS
OpenJDK Runtime Environment Zulu17.34+19-CA (build 17.0.3+7-LTS)
OpenJDK 64-Bit Server VM Zulu17.34+19-CA (build 17.0.3+7-LTS, mixed mode, sharing)

Image Removed

Note: JDKs are also available from https://adoptopenjdk.net/, but they won't provide JavaFX, which breaks most of IHMC's robotics software.

Mac OS X

Download JDK and JavaFX from https://adoptopenjdk.net/ or https://www.azul.com/downloads/zulu/zulufx/

Download JavaFX 17 from https://www.azul.com/downloads/zulu-community/zulufx/

Windows

Configuration

Logging

See the IHMC Log Tools README for details on enabling different log levels.

Testing

For testing in IDE, see Unit Testing/wiki/spaces/HOWTO/pages/14288377. For testing with Gradle and on Bamboo, see IHMC CI Gradle plugin and Integrating with Bamboo /wiki/spaces/HOWTO/pages/14288249.

JVM options

...

See Java Platform Module System

Learning Resources

• Guide: Learning Java
• The Java™ Tutorials
• Thinking in Java (ISBN 978-0131872486) by Bruce Eckel

...