本页采用了机器翻译。点击此处可查看英文原文。

为部署设置 MATLAB Runtime 库路径

使用 MATLAB® Compiler™ 或 MATLAB Compiler SDK™ 生成的应用程序需要访问 MATLAB Runtime 库才能正常运行。MATLAB Runtime 提供了必要的组件，使这些已编译的应用程序无需安装 MATLAB 即可运行。这些应用程序会通过系统中的库路径环境变量来定位所需的库。

在 Windows® 上，MATLAB Runtime 的安装程序会在安装过程中自动设置库路径。在 Linux® 和 macOS 系统上，安装 MATLAB Runtime 后，请手动将相应的库文件夹添加到系统路径中。请按照您所使用的操作系统和 shell 环境的说明进行操作。

对于运行在 Linux 和 macOS 上的独立应用程序，MATLAB Compiler 会生成一个名为 run_application.sh 的 shell 脚本。您将 MATLAB Runtime 的位置作为参量传递给脚本，脚本随后会设置库路径。在启动独立应用程序时，可使用此脚本作为指定运行时位置的替代方法。例如：

./run_application.sh <MATLAB_RUNTIME_INSTALL_DIR> [arguments]

注意

  • 您的库路径可能包含多个版本的 MATLAB Runtime。未使用 shell 脚本启动的应用程序会使用路径中列出的第一个版本。

  • 在修改当前库路径的值之前，请将其保存为备份。

  • 如果您通过网络安装 MATLAB Runtime，请参阅在网络驱动器上部署应用程序和 MATLAB Runtime。

库路径环境变量和 MATLAB Runtime 文件夹

操作系统环境变量目录
WindowsPATH<MATLAB_RUNTIME_INSTALL_DIR>\runtime\win64
LinuxLD_LIBRARY_PATH

<MATLAB_RUNTIME_INSTALL_DIR>/runtime/glnxa64

<MATLAB_RUNTIME_INSTALL_DIR>/bin/glnxa64

<MATLAB_RUNTIME_INSTALL_DIR>/sys/os/glnxa64

<MATLAB_RUNTIME_INSTALL_DIR>/extern/bin/glnxa64

macOS（Apple 芯片）DYLD_LIBRARY_PATH

<MATLAB_RUNTIME_INSTALL_DIR>/runtime/maca64

<MATLAB_RUNTIME_INSTALL_DIR>/bin/maca64

<MATLAB_RUNTIME_INSTALL_DIR>/sys/os/maca64

<MATLAB_RUNTIME_INSTALL_DIR>/extern/bin/maca64

Windows

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

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

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

    注意

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

  3. 点击新建并添加文件夹 <MATLAB_RUNTIME_INSTALL_DIR>\runtime\<arch>。

    例如，如果您正在 64 位 Windows 系统上使用位于默认安装文件夹中的 MATLAB Runtime R2026a，请添加 C:\Program Files\MATLAB\MATLAB Runtime\R2026a\runtime\win64。

  4. 点击确定应用更改。

注意

如果路径中包含多个版本的 MATLAB Runtime，则应用程序将使用路径中列出的第一个版本。

Linux

有关在 Bash 以外的 shell 中设置环境变量的信息，请参阅 shell 文档。

Bash Shell

  1. 在终端中显示 LD_LIBRARY_PATH 的当前值。

    echo $LD_LIBRARY_PATH

  2. 将 MATLAB Runtime 文件夹追加到当前会话的 LD_LIBRARY_PATH 变量。

    例如，如果您使用的是位于默认安装文件夹中的 MATLAB Runtime R2026a，请使用以下命令。

    export LD_LIBRARY_PATH="${LD_LIBRARY_PATH:+${LD_LIBRARY_PATH}:}\
/usr/local/MATLAB/MATLAB_Runtime/R2026a/runtime/glnxa64:\
/usr/local/MATLAB/MATLAB_Runtime/R2026a/bin/glnxa64:\
/usr/local/MATLAB/MATLAB_Runtime/R2026a/sys/os/glnxa64:\
/usr/local/MATLAB/MATLAB_Runtime/R2026a/extern/bin/glnxa64"

    注意

    在 R2025a 之前的版本中: 如果您需要使用 Mesa Software OpenGL® 的渲染功能来解决底层图形问题，请将文件夹 <MATLAB_RUNTIME_INSTALL_DIR>/sys/opengl/lib/glnxa64 添加到路径中。

  3. 显示 LD_LIBRARY_PATH 的新值以确保路径正确。

    echo $LD_LIBRARY_PATH

  4. 输入 ldd --version 以检查您的 GNU® C 库 (glibc) 的版本。如果显示的版本是 2.17 或更低版本，请使用以下命令将 <MATLAB_RUNTIME_INSTALL_DIR>/bin/glnxa64/glibc-2.17_shim.so 添加到 LD_PRELOAD 环境变量。

    export LD_PRELOAD="${LD_PRELOAD:+${LD_PRELOAD}:}\
/usr/local/MATLAB/MATLAB_Runtime/R2026a/bin/glnxa64/glibc-2.17_shim.so"

  5. 若要使这些更改永久生效，请参阅 永久设置库路径。

macOS

  1. 在终端中显示 DYLD_LIBRARY_PATH 的当前值。

    echo $DYLD_LIBRARY_PATH

  2. 将 MATLAB Runtime 文件夹追加到当前会话的 DYLD_LIBRARY_PATH 变量。

    例如，如果您使用的是位于默认安装文件夹中的 MATLAB Runtime R2026a，请使用以下命令。

    export DYLD_LIBRARY_PATH="${DYLD_LIBRARY_PATH:+${DYLD_LIBRARY_PATH}:}\
/Applications/MATLAB/MATLAB_Runtime/R2026a/runtime/maca64:\
/Applications/MATLAB/MATLAB_Runtime/R2026a/bin/maca64:\
/Applications/MATLAB/MATLAB_Runtime/R2026a/sys/os/maca64:\
/Applications/MATLAB/MATLAB_Runtime/R2026a/extern/bin/maca64"

  3. 显示 DYLD_LIBRARY_PATH 的值以确保路径正确。

    echo $DYLD_LIBRARY_PATH

  4. 若要使这些更改永久生效，请参阅 永久设置库路径。

永久设置库路径

Windows

关于永久性路径设置的内容，已在 Windows 部分通过系统属性对话框进行了说明。

Linux 和 macOS

要在 Linux 或 macOS 上永久设置库路径：

  1. 运行以下命令以确定您的 shell：

    echo $SHELL

  2. 将 export 命令添加到您的 shell 配置文件中：

    • 对于 Bash 壳层，请编辑 ~/.bash_profile 或 ~/.bashrc。

    • 对于 Zsh，请编辑 ~/.zprofile 或 ~/.zshrc。

  3. 使用 export 命令添加上述 Linux 或 macOS 部分中的相应目录。

    例如，如果您正在 Bash 终端中使用 Linux，且 MATLAB Runtime R2026a 位于默认安装文件夹中，请在 ~/.bashrc 中添加以下命令。

    export LD_LIBRARY_PATH="${LD_LIBRARY_PATH:+${LD_LIBRARY_PATH}:}\
/usr/local/MATLAB/MATLAB_Runtime/R2026a/runtime/glnxa64:\
/usr/local/MATLAB/MATLAB_Runtime/R2026a/bin/glnxa64:\
/usr/local/MATLAB/MATLAB_Runtime/R2026a/sys/os/glnxa64:\
/usr/local/MATLAB/MATLAB_Runtime/R2026a/extern/bin/glnxa64"

  4. 保存文件，并在当前会话中重新加载以应用更改。

    source ~/.bashrc  # Bash
source ~/.zshrc   # Zsh

小心

永久设置 MATLAB 库路径可能会与使用相同库路径的其他应用程序发生冲突。请考虑以下替代方案：

  • 在测试期间，仅为当前会话设置路径。

  • 使用在执行前设置环境的特定应用程序包装器脚本。

另请参阅

主题