主要内容

compiler.runtime.customInstaller

MATLAB Compiler 生成的指定文件创建 MATLAB Runtime 安装程序

自 R2024b 起

说明

compiler.runtime.customInstaller(installerName, results) 创建一个占用空间最小的 MATLAB® Runtime 安装程序,该安装程序仅安装运行使用 MATLAB Compiler™MATLAB Compiler SDK™ 创建的指定工件所需的 MATLAB Runtime 组件。您可以使用 results(一个包含由任何 compiler.build 函数创建的由一个或多个 compiler.build.Results 对象组成的向量)指定工件。

示例

compiler.runtime.customInstaller(installerName, filepath) 使用由 MATLAB Compiler 生成的 requiredMCRProducts.txt 文件的列表创建 MATLAB Runtime 安装程序。

示例

compiler.runtime.customInstaller(___,Name=Value) 使用指定为一个或多个名称-值参量的额外选项创建 MATLAB Runtime 安装程序。选项包括输出文件夹、包类型和运行时交付方法。

示例

示例

全部折叠

创建一个最小的 MATLAB Runtime 安装程序,该安装程序仅安装运行独立应用程序所需的所有 MATLAB Runtime 组件。

编写一个 MATLAB 函数以打包为独立应用程序。对于此示例,使用文件 magicsquare.m 进行编译。

copyfile(fullfile(matlabroot,"extern","examples","compiler","magicsquare.m"));

使用 compiler.build.standaloneApplication 创建独立应用程序。将函数的输出保存为 compiler.build.Results 对象。

results = compiler.build.standaloneApplication("magicsquare.m");

创建一个包含运行独立应用程序所需组件的 MATLAB Runtime 安装程序。

compiler.runtime.customInstaller("magicsquareInstaller",results);

将独立应用程序和生成的 MATLAB Runtime 安装程序部署在目标计算机上。

这一安装的 MATLAB Runtime 占用的空间小于完整的 MATLAB Runtime 安装。

通过使用完整 MATLAB Runtime 安装程序在离线计算机上创建一个最小的 MATLAB Runtime 安装程序。

使用连接到 Internet 的计算机,下载适用于离线计算机的 MATLAB 版本的完整 MATLAB Runtime 安装程序。有关详细信息,请参阅下载并安装 MATLAB Runtime (MATLAB Compiler SDK)。将安装程序传输到离线计算机。

在离线计算机上,在 MATLAB 中,打开预设项菜单并选择 MATLAB Compiler。指定 MATLAB Runtime 安装程序的位置。

在离线计算机上,编写一个 MATLAB 函数以打包为独立应用程序。对于此示例,使用文件 magicsquare.m 进行编译。

copyfile(fullfile(matlabroot,"extern","examples","compiler","magicsquare.m"));

使用 compiler.build.standaloneApplication 创建独立应用程序。将函数的输出保存为 compiler.build.Results 对象。

results = compiler.build.standaloneApplication("magicsquare.m");

创建一个包含运行独立应用程序所需组件的 MATLAB Runtime 安装程序。

compiler.runtime.customInstaller("magicsquareInstaller",results);

将独立应用程序和生成的 MATLAB Runtime 安装程序部署在目标计算机上。

使用由 MATLAB Compiler 生成的 requiredMCRProducts.txt 文件在 Windows® 上创建 MATLAB Runtime 安装程序。

编写一个 MATLAB 函数以打包为独立的 Windows 应用程序中。对于此示例,请将 MATLAB 脚本 flames.m 和数据文件 flames.mat 复制到当前工作目录中。

copyfile(fullfile(matlabroot,"extern","examples","compiler","flames.*"));

使用 mcc 通过 flames.m 创建独立 Windows 应用程序。

mcc("flames.m","-e","-a","flames.mat","-d","flames")

使用文件 houdini.m 创建 Excel® 加载项。

copyfile(fullfile(matlabroot,"extern","examples","compiler","houdini.m"));
compiler.build.excelAddIn("houdini.m","GenerateVisualBasicFile","on","OutputDir","houdini");

创建一个包含运行独立应用程序和 Excel 加载项所需组件的 MATLAB Runtime 安装程序。

compiler.runtime.customInstaller("flames_houdiniInstaller",...
["flames\requiredMCRProducts.txt","houdini\requiredMCRProducts.txt"]);

将在文件夹 flames_houdiniInstaller 中生成一个名为 flames_houdiniInstaller.exeMATLAB Runtime 安装程序。

创建一个 MATLAB Runtime 安装程序,该安装程序将安装运行多个 C++ 共享库所需的所有 MATLAB Runtime 组件。

对于此示例,请将 MATLAB 附带的 matrix 文件夹复制到您的工作文件夹。

copyfile(fullfile(matlabroot,"extern","examples","compilersdk","c_cpp","matrix"),"matrix")

导航到工作文件夹中的新 matrix 子文件夹。

使用 compiler.build.cppSharedLibrary 创建两个 C++ 共享库。

functionfiles = {"addmatrix.m", "multiplymatrix.m", "eigmatrix.m"};

results1 = compiler.build.cppSharedLibrary(functionfiles,...
"OutputDir","matrixLibraries");

results2 = compiler.build.cppSharedLibrary("subtractmatrix.m",...
"OutputDir","matrixLibraries");

创建一个可用于所有库的 MATLAB Runtime 安装程序。使用名称-值参量指定编译文件夹并将 MATLAB Runtime 嵌入在安装程序中以用于离线部署。

compiler.runtime.customInstaller("matrixInstaller",[results1,results2],...
OutputDir="customInstallers",RuntimeDelivery="installer")

将在当前工作目录的 customInstallers 文件夹中生成安装程序 matrixInstaller.zip

MATLAB Runtime 安装程序和共享库文件(.ctf.hpp)部署到目标计算机。

输入参数

全部折叠

安装程序文件的名称,指定为字符向量或字符串标量。扩展名由执行该函数的操作系统决定。

示例: "MagicSquare_Installer"

compiler.build 函数创建的一个或多个编译结果,例如 compiler.build.standaloneApplicationcompiler.build.productionServerArchive (MATLAB Compiler SDK),指定为由 compiler.build.Results 对象组成的向量。

示例: [results1,results2]

MATLAB CompilerMATLAB Compiler SDK 生成的 requiredMCRProducts.txt 的一个或多个路径。

示例: ["fun1/requiredMCRProducts.txt","fun2/requiredMCRProducts.txt"]

名称-值参数

全部折叠

将可选参量对组指定为 Name1=Value1,...,NameN=ValueN,其中 Name 是参量名称,Value 是对应的值。名称-值参量必须出现在其他参量之后,但对各个参量对组的顺序没有要求。

示例: PackageType="zip"

自 R2025a 起

要包含在安装程序中的可选 MATLAB Runtime 依赖项,指定为以下选项之一:

  • "all" - 使用此选项可将所有可选依赖项包含在安装程序中,包括图形化支持。此选项是默认行为。

  • "none" - 使用此选项则不会将任何可选依赖项包含在安装程序中。使用此选项可最大程度减小生成的安装程序的大小。

示例: OptionalDependencies="none"

保存安装程序的输出目录的路径,指定为字符向量或字符串标量。该路径可以是相对于当前工作目录的路径,也可以是绝对路径。

输出文件夹的默认名称是 installerName 的值。

示例: OutputDir="D:\Documents\MATLAB\work\myappInstaller"

数据类型: char | string

安装程序文件类型,指定为以下选项之一。

  • "auto" - 使用此选项时,在创建安装程序时安装程序将自动选择合适的文件类型。如果安装程序大小为 2GB 或更大,则安装程序将打包为 ZIP 文件。这是默认选项。

  • "zip" - 如果使用此选项,则在创建新安装程序时将始终生成 ZIP 文件作为输出。只有当 RuntimeDelivery 设置为 "installer" 时才支持此选项。只有 Windows 系统支持此选项。

示例: PackageType="zip"

数据类型: char | string

MATLAB Runtime 交付方法,指定为以下选项之一。

  • "web" - 如果使用此选项,安装程序将在安装应用程序期间从 MathWorks® 网站下载 MATLAB Runtime。这是默认选项。

  • "installer" - 如果使用此选项,将在安装程序中包括 MATLAB,以便在安装应用程序期间无需连接到 MathWorks 网站便可安装它。如果您认为您的最终用户可能无法访问 Internet,请使用此选项。

示例: RuntimeDelivery="installer"

数据类型: char | string

提示

  • 此函数创建的安装程序仅安装部分 MATLAB Runtime 组件,占用最少的空间。要下载完整的 MATLAB Runtime 安装程序,请参阅 compiler.runtime.download

  • 如果您要使用此函数创建的多个安装程序,则 MATLAB Runtime 会更新为包含所有这些安装程序中组件的最小子集。这意味着,通过使用每个编译创建的自定义安装程序,您可以使用相同的 MATLAB Runtime 实例运行多个 MATLAB Compiler 生成工件。

  • 此函数创建的安装程序不安装 MATLAB Compiler 生成工件。要为打包的 MATLAB 代码创建安装程序,请参阅 compiler.package.installer

版本历史记录

在 R2024b 中推出

全部展开