配置用于生成 Java 包的环境

在使用 MATLAB® Compiler SDK™ 生成 Java® 包或运行 Java 应用程序之前，请确保已正确配置 Java 环境。您必须确认：

  • 您的开发系统使用的 Java 开发人员工具包 (JDK™) 版本与 MATLAB 兼容。有关更新的 Java 系统要求，请参阅 MATLAB 支持的其他语言接口。

  • JAVA_HOME 环境变量设置为包含 Java 安装的文件夹。

  • 您的 classpath 包含 MATLAB javabuilder 库 JAR 文件以及包含编译 MATLAB 代码的包的 JAR 文件。您可以在 javac 命令或 CLASSPATH 系统环境变量中指定 classpath。

  • 您的目标计算机已安装 MATLAB 或 MATLAB Runtime。有关如何安装 MATLAB Runtime 的说明，请参阅下载并安装 MATLAB Runtime。

安装 JDK 或 JRE

要开发 Java 应用程序，您必须安装正确版本的 Java 开发人员工具包 (JDK)。如果您不编译 MATLAB 代码，也不开发 Java 应用程序，则可以安装 Java 运行时环境 (JRE™) 而不是 JDK 来运行 Java 应用程序。

  1. 通过运行以下 MATLAB 命令来验证您的 MATLAB 安装所使用的 Java 版本：

    version -java

  2. 从 https://adoptium.net/ 下载并安装具有相同主版本的 JDK。例如，如果 version -java 返回 Java 1.8.X，则安装 OpenJDK 8。

    在 Windows® 中，您可以在自定义安装屏幕上选择设置 JAVA_HOME 变量选项，以便在安装过程中自动设置 JAVA_HOME 环境变量。

设置 JAVA_HOME 环境变量

安装 JDK 或 JRE 后，如果您在安装过程中尚未将系统环境变量 JAVA_HOME 设置为您的 Java 安装文件夹，请将其设置为该文件夹。

  1. 根据您的操作系统，请参照下表永久设置 JAVA_HOME。

    操作系统过程
    Windows

    1. 运行 C:\Windows\System32\SystemPropertiesAdvanced.exe 并点击环境变量... 按钮。

    2. 选择系统变量 JAVA_HOME，然后点击编辑...。

      如果您没有计算机的管理员权限，请选择用户变量 JAVA_HOME 而非系统变量。

    3. 点击新建并将路径添加到您的 Java 安装文件夹中。例如，C:\Program Files\AdoptOpenJDK\jdk-8.0.282.8-hotspot。

    4. 点击确定以应用更改。

    Linux®

    在 Bash shell 中，输入以下命令： 

    echo "export JAVA_HOME=<path_to_Java_install>" >> ~/.bash_profile
    source ~/.bash_profile

    macOS（Mojave 10.14 或更低版本）

    在 Bash shell 中，输入以下命令： 

    echo "export JAVA_HOME=<path_to_Java_install>" >> ~/.profile
    source ~/.profile

    macOS（Catalina 10.15 或更高版本）

    在 Zsh shell 中，输入以下命令：

    echo "export JAVA_HOME=<path_to_Java_install>" >> ~/.zprofile
    source ~/.zprofile

  2. 如果您编译的是 MATLAB 代码，请验证 MATLAB 是否读取了正确的 JAVA_HOME 值。

    在 MATLAB 命令提示符下，键入 getenv JAVA_HOME 以显示 JAVA_HOME 的值。

设置 CLASSPATH

要编译和运行使用 MATLAB Compiler SDK 生成的组件的 Java 应用程序，类路径必须包含：

  • com.mathworks.toolbox.javabuilder 包中的类，该包位于 matlabroot/toolbox/javabuilder/jar/javabuilder.jar 下，其中 matlabroot 表示您的 MATLAB 或 MATLAB Runtime 安装文件夹。

  • 您开发的 Java 包。

当您编译 Java 应用程序时，必须在 javac 命令或 CLASSPATH 系统环境变量中指定 classpath。同样，当您部署 Java 应用程序时，最终用户必须在 java 命令或 CLASSPATH 系统环境变量中指定 classpath。有关设置类路径的示例，请参阅编译和运行 MATLAB 生成的 Java 应用程序。

设置共享库路径变量

将 Java 安装的 bin 子文件夹添加到共享库路径环境变量中。

根据您的操作系统，请参照下表设置库路径。

操作系统过程
Windows

Windows 版的 OpenJDK 安装程序会在安装过程中自动设置库路径。如果不使用安装程序，请完成以下步骤以永久设置 PATH 环境变量。

  1. 运行 C:\Windows\System32\SystemPropertiesAdvanced.exe 并点击环境变量... 按钮。

  2. 选择系统变量 Path，然后点击编辑...。

    如果您没有计算机的管理员权限，请选择用户变量 Path 而非系统变量。

  3. 点击新建并将路径添加到 <path_to_Java_install>\bin 文件夹中。

  4. 点击确定以应用更改。

Linux

在 Bash shell 中，输入以下命令： 

echo "export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:<path_to_Java_install>/bin" >> ~/.bash_profile
source ~/.bash_profile

macOS（Mojave 10.14 或更低版本）

在 Bash shell 中，输入以下命令： 

echo "export DYLD_LIBRARY_PATH=$DYLD_LIBRARY_PATH:<path_to_Java_install>/bin"\
 >> ~/.profile
source ~/.bash_profile

macOS（Catalina 10.15 或更高版本）

在 Zsh shell 中，输入以下命令：

echo "export DYLD_LIBRARY_PATH=$DYLD_LIBRARY_PATH:<path_to_Java_install>/bin"\
 >> ~/.zprofile
source ~/.zprofile

注意

为了运行包含编译的 MATLAB 代码的 Java 应用程序，您必须在系统库路径中包含 MATLAB 或 MATLAB Runtime 库文件夹。有关详细信息，请参阅针对部署设置 MATLAB Runtime 路径。

另请参阅

主题