使用 Excel 集成为 MATLAB Production Server 创建和安装可部署存档

支持的平台：仅限 Microsoft^® Windows^®。

此示例说明如何使用 Excel^® 函数创建与 MATLAB^® 集成的可部署存档。然后，您可以在 MATLAB Production Server™ 上部署生成的存档。

前提条件

MATLAB Compiler SDK™ 需要 .NET framework 4.0 或更高版本来为 MATLAB Production Server 构建 Excel 加载项。

要生成 Excel 加载项文件 (.xla)，请启用 Excel 中 Trust access to the VBA project object model。如果您不这样做，您可以通过将 .bas 文件导入 Excel 来手动创建加载项。

在 MATLAB 中创建函数

在 MATLAB 中，检查您想要打包的 MATLAB 程序。

对于此示例，编写一个函数 mymagic.m 如下。

function y = mymagic(x)

y = magic(x);

在 MATLAB 命令提示符下，输入 mymagic(3) 来检查函数的输出。

 ans =
     8     1     6
     3     5     7
     4     9     2

使用 `compiler.build.excelClientForProductionServer` 创建可部署的 Excel 集成存档

使用编程方法创建与 Excel 集成的可部署存档。

使用 mymagic.m 创建生产服务器存档并将构建结果保存到 compiler.build.Results 对象。
```
buildResults = compiler.build.productionServerArchive('mymagic.m');
```
使用 compiler.build.excelClientForProductionServer 函数构建与 Excel 集成的可部署存档。
```
mpsxlResults = compiler.build.excelClientForProductionServer(buildResults, ...
'Verbose','on');
```
您可以使用名称-值参量在 compiler.build 命令中指定其他选项。有关详细信息，请参阅 compiler.build.excelClientForProductionServer (MATLAB Compiler SDK)。
compiler.build.Results 对象 buildResults 包含有关编译类型、生成的文件、包含的支持包和编译选项的信息。
该函数会在当前工作目录中名为 mymagicexcelClientForProductionServer 的文件夹中生成以下文件：
- includedSupportPackages.txt - 列出程序集中包含的所有支持文件的文本文件。
- mymagic.bas - 可以导入到 VBA 工程中的 VBA 模块文件。
- mymagic.dll - Excel 加载项所需的动态库。
- mymagic.reg - 包含有关未解析符号的信息的文本文件。
- mymagic.xla - 可直接在 Excel 中安装的 Excel 加载项。
- mymagicClass.cs - 包含有关未解析符号的信息的文本文件。
- mccExcludedFiles.log - 包含应用程序中未包含的任何工具箱函数列表的日志文件。有关不支持的函数的信息，请参阅 MATLAB Compiler 限制 (MATLAB Compiler)。
- readme.txt - 包含打包和部署信息的文本文件。
- requiredMCRProducts.txt - 包含 MATLAB Runtime 运行应用程序所需产品的产品 ID 的文本文件。
注意
生成的 Excel 加载项不包括 MATLAB Runtime 或安装程序。要使用 buildResults 对象创建安装程序，请参阅 compiler.package.excelClientForProductionServer (MATLAB Compiler SDK)。

使用 `mcc` 创建可部署的 Excel 集成存档

作为 compiler.build.excelClientForProductionServer 的替代方法，您也可以使用 mcc 函数，通过运行以下命令来创建可部署存档。

mcc -W CTF:mymagic -U -d '[Target server directory]' -v [directory containing mymagic.m]

```
mcc -W 'mpsxl:mymagic,Class1,version=1.0' -b -d '[Target client directory]' -v [Location of mymagic.m] class{Class1:[location of mymagic.m]} 
```
注意
生成的 Excel 加载项不包括 MATLAB Runtime 或安装程序。要创建安装程序，请参阅 compiler.package.excelClientForProductionServer (MATLAB Compiler SDK)。

在服务器上安装具有 Excel 集成的可部署存档

您必须先将存档部署到 MATLAB Production Server 实例，然后才能在 Excel 中使用该加载项。

要在服务器实例上安装可部署存档：

找到可部署存档（CTF 文件），如果使用了 compiler.build.productionServerArchive 函数，存档将位于 mymagicproductionServerArchive 文件夹中。如果您使用 mcc，则文件就在您的工作文件夹中。
对于此示例，文件名是 mymagic.ctf。
将存档文件复制到服务器实例的 auto_deploy 文件夹。服务器实例会自动部署它并让感兴趣的客户端可以使用它。

在客户端上安装 Excel 加载项

如果使用了 compiler.build.productionServerArchive 函数，请在结果上运行 compiler.package.excelClientForProductionServer (MATLAB Compiler SDK) 以生成安装程序，安装程序位于 mymagicinstaller 文件夹中。这里，它被命名为 MyAppInstaller.exe。
打开安装程序并按照说明进行操作。
客户端上安装的文件包括：
- mymagic.bas
- mymagic.dll
- mymagic.xla
- readme.txt
- ServerConfig.dll

另请参阅

compiler.package.excelClientForProductionServer (MATLAB Compiler SDK) | mcc (MATLAB Compiler)