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

部署失败

R2026b

应用程序在测试计算机上运行后，可以在最终用户部署中隔离故障。您的应用程序的最终用户需要在他们的计算机上安装 MATLAB® Runtime。MATLAB Runtime 包括一组共享库，为 MATLAB 的所有功能提供支持。如果您的应用程序在最终用户部署期间失败，以下问题可能会帮助您隔离问题。

注意

您的应用程序在测试环境中成功运行后可能无法部署给最终用户的原因有很多。有关编写最终用户可使用的 MATLAB 代码的详细指南列表，请参阅编写可部署的 MATLAB 代码

任何部署目标都需要安装 MATLAB Runtime。有关详细信息，请参阅下载并安装 MATLAB Runtime。

有关安装 MATLAB Runtime 后在部署计算机上设置路径的信息，请参阅为部署设置 MATLAB Runtime 库路径。

错误消息表明缺少 DLL（例如 mclmcrrtX_XX.dll 或 mclmcrrtX_XX.so 通常是由 MATLAB Runtime 安装不正确引起的。有关安装 MATLAB Runtime 的信息，请参阅下载并安装 MATLAB Runtime。

MATLAB Runtime 也可能安装正确，但 PATH、LD_LIBRARY_PATH 或 DYLD_LIBRARY_PATH 变量设置不正确。有关设置环境变量的信息，请参阅为部署设置 MATLAB Runtime 库路径。

小心

不要通过移动 MATLAB Runtime 文件夹结构内的库或其他文件来解决这些问题。MATLAB Runtime 系统设计用于适应在同一台计算机上运行的不同 MATLAB Runtime 版本。文件夹结构是此功能的重要组成部分。

具有已编译 MATLAB 代码的应用程序尝试执行的第一个操作是提取可部署存档。如果未提取存档，应用程序将无法访问已编译的 MATLAB 代码，并且应用程序将失败。

可部署存档提取到的可能文件夹有三个：

  • 如果可部署存档已嵌入并且您正在使用默认环境设置，则存档提取到当前用户的临时文件夹中。

  • 如果可部署存档已嵌入并且您设置了环境变量 MCR_CACHE_ROOT，则存档提取到 MCR_CACHE_ROOT 指定的文件夹中。

  • 如果未嵌入可部署存档，则存档提取到组件的当前文件夹中。