使用 Excel 加载项编译器创建 Excel 加载项

支持的平台：Windows^®、Linux^®、Mac

此示例展示了如何使用 Excel 加载项编译器将 MATLAB^® 函数打包到 Excel^® 加载项中。您可以使用 Microsoft^® Excel 调用该函数。

在 R2025a 之前的版本中: 使用库编译器创建一个 Excel 加载项，如使用库编译器从 MATLAB 函数创建 Microsoft Excel 加载项 (R2024b)中所示。

创建 MATLAB 函数

在 MATLAB 中，编写一个您想要部署的 MATLAB 程序。

对于此示例，创建一个名为 mymagic.m 的函数。

function y = mymagic(x)
y = magic(x)

在 MATLAB 命令提示符下，输入 mymagic(5)。

输出是一个 5×5 矩阵。

17    24     1     8    15
23     5     7    14    16
 4     6    13    20    22
10    12    19    21     3
11    18    25     2     9

创建工程和编译任务

使用 Excel 加载项编译器创建函数的编译任务。编译器任务允许您为特定部署目标编译工程中的文件。

要打开该 App，在 App 选项卡上，展开 App 图库。在应用程序部署部分，点击 Excel 加载项编译器。

Application Deployment section of the Apps gallery

您还可以在 MATLAB 命令行窗口中使用 excelAddinCompiler 函数打开该 App。

打开 App 后，“创建编译器任务”对话框会提示您将编译器任务添加到新的或现有 MATLAB 工程中。在此示例中，选择启动新工程并创建编译器任务，并在工作文件夹中创建一个名为 MagicProject 的新工程。有关创建和使用 MATLAB 工程的详细信息，请参阅创建工程。

Create compiler task dialog box with the text 'To deploy your MATLAB code, you need a MATLAB project to organize code and a compiler task to handle deployment.' The option 'Start a new project and create a compiler task' is selected.

编辑器中打开了一个名为 ExcelAddIn1 的新编译任务。您可以通过打开编译器任务管理器或转到管理任务选项卡并创建一个新的编译器任务来编译其他部署目标的代码。

指定编译选项

在打包之前，您可以为 Excel 加载项指定选项，以自定义构建和打包过程。例如，您可以对 MATLAB 代码进行混淆处理。

在此示例中，在编译器任务的导出的函数部分，点击添加导出的函数，然后选择 mymagic.m。在“工程”面板中，该文件现在带有标签 Design 和 Exported Function File。

Exported file section of the compiler task with no file selected and a button labeled Add Exported Function

在包信息部分，将字符串 MyExcelAddIn 替换为您的 Excel 加载项的名称 xlmagic。

在编译设置部分，将字符串 Class1 替换为类名 xlmagicclass。

查看代码和软件包 Excel 加载项

要查看包含有关构建和打包组件的说明的代码，请点击导出编译脚本按钮旁边的箭头，然后选择显示代码。在右侧，将打开一个窗口，显示一个部署脚本，其中包含与您的构建选项相对应的 compiler.build.excelAddIn 和 compiler.package.installer 函数。

Two buttons labeled Export Build Script and Build and Package

要创建 Excel 加载项，请点击打包。

编译器会在工程文件夹中的 <compiler_task_name>/output 文件夹中生成文件。要为生成的文件选择不同的输出位置，请更新输出位置部分中的路径。

测试和部署加载项

创建加载项后，请按照以下步骤在 Microsoft Excel 中测试该函数。

打开 Microsoft Excel，点击文件选项卡，点击选项，然后点击加载项类别。
在管理框中，点击 Excel 加载项，然后点击转到。系统将显示加载项对话框。
点击浏览并找到加载项 xlmagic.xla。
系统会提示您将 xlmagic.xla 复制到与您的用户名关联的 Addins 文件夹。您可以选择复制该加载项或直接运行它。对于此示例，选择是。该加载项将被复制并添加到您的工作簿。
点击确定关闭加载项对话框。
要测试加载项，请在 Excel 工作簿中选择一个 3×3 的单元格网格。
然后，在公式栏中输入此自定义函数。
```
=mymagic(3)
```
按下键盘上的 Ctrl + Shift + Enter。选中的单元格显示此输出。
```
8    1    6
3    5    7
4    9    2
```

有关其他示例，请打开位于 matlabroot\toolbox\matlabxl\examples\xlmagic 中的文件 xlmagic.xls。此电子表格包含三个自定义 VBA 宏，演示了如何使用编译后的 MATLAB 函数。

要将加载项分发给最终用户，请参阅分发加载项并集成到 Microsoft Excel 中。

另请参阅

Excel 加载项编译器 | compiler.build.excelAddIn | compiler.package.installer