Before you can package MATLAB® functions into Java® applications or use the generated Java application in a Java development environment, you must ensure that your Java environment is properly configured. You should verify that:
Your system uses a version of the Java Developer’s Kit (JDK™) that is compatible with MATLAB.
JAVA_HOME
is set to the folder containing
the system’s JDK installation.
CLASSPATH
contains all of the MATLAB library JAR files and the JAR files for the applications
containing your packaged MATLAB code.
The MATLAB native library paths are properly configured.
Note
For updated Java system requirements, including versions of Java Developer's Kit (JDK) and Java Runtime Environment (JRE), see the supported compiler page at https://www.mathworks.com/support/compilers/current_release/.
To install the proper version of the JDK:
Verify the version of Java your MATLAB installation is using by running the following MATLAB command:
version -java
Download a Java Developer's Kit (JDK) with the same major version from https://adoptopenjdk.net/.
Install the JDK.
Note
If you are not developing applications or compiling MATLAB code, you can use the Java Runtime Environment (JRE) instead of the JDK.
Set the system environment variable, JAVA_HOME
,
to point to your JDK installation.
At the MATLAB command prompt, type getenv
JAVA_HOME
to verify that MATLAB is reading the correct
version of JAVA_HOME
.
Verify that the folder containing your Java installation
has been added to your system PATH
environment variable.
To build and run a Java application that uses a MATLAB Compiler SDK™ generated package, the system must locate:
JAR files containing the MATLAB libraries
Applications that you have developed and built with the compiler
Java classes generated by the MATLAB
Compiler SDK software use classes contained in the
com.mathworks.toolbox.javabuilder
package. To use the
compiled classes, you should include a file called
javabuilder.jar
on the Java class path. You can find this file in one of the following
folders:
MATLAB installed on your system |
|
MATLAB Runtime installed on your system |
|
Note
matlabroot
refers to the root folder
into which the MATLAB installer has placed the MATLAB files. mcrroot
refers
to the root folder under which MATLAB Runtime is installed.
In addition, you should add to the JAR files created by the compiler to the class path.
The operating system uses the native library path to locate native libraries that are needed to run your Java class. See the following list of variable names according to operating system:
Windows® | PATH |
Linux® | LD_LIBRARY_PATH |
Macintosh | DYLD_LIBRARY_PATH |
The native MATLAB or MATLAB Runtime files needed to execute the packaged MATLAB functions called from the Java code must be included on the paths listed by your system’s native library path variable.