ArtiSynth Installation Guide for Linux

4 Installing Java

ArtiSynth requires that you have a full 64-bit Java development kit (JDK) installed. A JDK comes with a Java compiler, whereas the simpler Java run time environment (JRE) does not. Note, however, that a JDK usually includes a JRE.

Important: on ARM-based machines, you must still install a 64-bit Intel-based JDK which must then execute through an Intel compatibility layer. Invocation of the compatibility layer should generally be invisible to the user. 64-bit Intel-based JDKs contain the string x64 in their download names, whereas ARM-based JDKs contain aarch64 or arm32.

By default, ArtiSynth is compiled to be compliant with Java 8. While ArtiSynth will work under later Java versions, Java 8 provides compatibility with MATLAB (which still uses Java 8), as well as the Jython console. Therefore we currently recommend using Java 8; this also provides maximum compatibility with MATLAB and Jython, as indicated above. We specifically recommend the Java SE Development Kit 8uXXX (where XXX is the latest revision number), which can be obtained from Oracle (registration required). At the time of this writing, the download page is located at

and the latest release is 8u281. This page provides downloads for all systems; be sure to choose the download link appropriate to yours.

If the above Oracle link is no longer current, the search terms ``java 8 jdk download'' should get you to the right place.

4.1 Ensuring the JDK is visible to your system

After the JDK has been installed, it is important to ensure that it is visible to your system and that it supersedes any other Java installations. One test for this is to open a terminal window and run the command

 > javac -version

The output should match the version of the installed JDK. If it does not, or if the command javac is not found, then one fix is to add the directory <JDK_HOME>/bin to your system Path, as described in Section 14.1, where <JDK_HOME> is the JDK installation directory. In particular, <JDK_HOME>/bin should be added ahead of any other Java installations that might be specified on the Path. To see the current contents of the Path, open a terminal window and run the command

 > echo $PATH

If you are using an integrated development environment (IDE), such as Eclipse (Section 13), for compiling and running ArtiSynth programs, you should also ensure that this IDE is configured to use the installed JDK. Instructions on how to do this for Eclipse are given in Section 13.1.1.