使用 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 程序。

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

function y = mymagic(x)

y = magic(x);

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

 ans =
     8     1     6
     3     5     7
     4     9     2

使用编程方法创建与 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。
compiler.build.Results 对象 buildResults 包含有关编译类型、生成的文件、包含的支持包和编译选项的信息。
该构建函数会在当前工作目录下的一个名为 mymagicexcelClientForProductionServer 的文件夹中生成文件。有关生成的文件的信息，请参阅打包 MATLAB 函数后生成的文件。
注意
生成的 Excel 加载项不包括 MATLAB Runtime 或安装程序。要使用 buildResults 对象创建安装程序，请参阅 compiler.package.excelClientForProductionServer。

作为 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 Production Server 实例，然后才能在 Excel 中使用该加载项。

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

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

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

有关详细信息，请参阅 MATLAB Production Server 文档。

另请参阅