针对部署设置 MATLAB Runtime 路径

使用 MATLAB^® Compiler™ 或 MATLAB Compiler SDK™ 生成的应用程序使用系统库路径来定位 MATLAB Runtime 库。Windows^® 版 MATLAB Runtime 安装程序会在安装过程中自动设置库路径，但在 Linux^® 或 macOS 上，您必须手动添加库。安装 MATLAB Runtime 后，请根据操作系统和 shell 环境的说明将运行时文件夹添加到系统库路径中。

您也可以将 MATLAB Runtime 的位置作为输入传递到 Linux 或 macOS 上的关联 shell 脚本 (run_application.sh) 来启动应用程序。

注意

您的库路径可能包含多个版本的 MATLAB Runtime。未使用 shell 脚本启动的应用程序会使用路径中列出的第一个版本。
在修改当前库路径的值之前，请将其保存为备份。
如果您通过网络安装 MATLAB Runtime，请参阅在网络驱动器上部署应用程序和 MATLAB Runtime。

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

操作系统	环境变量	目录
Windows	`PATH`	`<MATLAB_RUNTIME_INSTALL_DIR>\runtime\<arch>`
Linux	`LD_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（Intel^® 处理器）	`DYLD_LIBRARY_PATH`	`<MATLAB_RUNTIME_INSTALL_DIR>/runtime/maci64` `<MATLAB_RUNTIME_INSTALL_DIR>/bin/maci64` `<MATLAB_RUNTIME_INSTALL_DIR>/sys/os/maci64` `<MATLAB_RUNTIME_INSTALL_DIR>/extern/bin/maci64`
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 环境变量。

运行 C:\Windows\System32\SystemPropertiesAdvanced.exe 并点击环境变量... 按钮。
选择系统变量 Path，然后点击编辑...。

注意
如果您没有计算机的管理员权限，请选择用户变量 Path 而非系统变量。
点击新建并添加文件夹 <MATLAB_RUNTIME_INSTALL_DIR>\runtime\<arch>。
例如，如果您使用的是 64 位 Windows 上默认安装文件夹中的 MATLAB Runtime R2025a，请添加 C:\Program Files\MATLAB\MATLAB Runtime\R2025a\runtime\win64。
点击确定以应用更改。

注意

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

Linux

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

Bash Shell

在终端中显示 LD_LIBRARY_PATH 的当前值。
```
echo $LD_LIBRARY_PATH
```
将 MATLAB Runtime 文件夹追加到当前会话的 LD_LIBRARY_PATH 变量。
例如，如果您使用的是默认安装文件夹中的 MATLAB Runtime R2025a，请使用以下命令。
```
export LD_LIBRARY_PATH="${LD_LIBRARY_PATH:+${LD_LIBRARY_PATH}:}\
/usr/local/MATLAB/MATLAB_Runtime/R2025a/runtime/glnxa64:\
/usr/local/MATLAB/MATLAB_Runtime/R2025a/bin/glnxa64:\
/usr/local/MATLAB/MATLAB_Runtime/R2025a/sys/os/glnxa64:\
/usr/local/MATLAB/MATLAB_Runtime/R2025a/extern/bin/glnxa64"
```
注意
在 R2025a 之前的版本中: 如果您需要使用 Mesa Software OpenGL^® 的渲染功能来解决底层图形问题，请将文件夹 <MATLAB_RUNTIME_INSTALL_DIR>/sys/opengl/lib/glnxa64 添加到路径中。
显示 LD_LIBRARY_PATH 的新值以确保路径正确。
```
echo $LD_LIBRARY_PATH
```
输入 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/R2025a/bin/glnxa64/glibc-2.17_shim.so"
```
要使这些更改永久生效，请参阅在 UNIX 上永久设置路径。

macOS

在终端中显示 DYLD_LIBRARY_PATH 的当前值。
```
echo $DYLD_LIBRARY_PATH
```

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

例如，如果您使用的是默认安装文件夹中的 MATLAB Runtime R2025a，请根据您的系统架构使用以下命令之一。

对于基于 Intel 处理器的 macOS，请使用 maci64 目录。

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

对于基于 Apple 芯片的 macOS，请使用 maca64 目录。

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

显示 DYLD_LIBRARY_PATH 的值以确保路径正确。
```
echo $DYLD_LIBRARY_PATH
```
要使这些更改永久生效，请参阅在 UNIX 上永久设置路径。

在 UNIX 上永久设置路径

小心

MATLAB Runtime 库可能与使用库路径的其他应用程序冲突。在这种情况下，仅针对当前会话设置路径，或使用生成的 shell 脚本运行 MATLAB Compiler SDK 应用程序。

要在 Linux 或 macOS 上登录时设置环境变量，请将 export 命令追加到 Bash shell 中的 shell 配置文件 ~/.bash_profile 或 Zsh shell 中的 ~/.zprofile。

要确定当前的 shell 环境，请键入 echo $SHELL。