前提条件

创建 MATLAB 函数

在 MATLAB 中，检查您想要打包的 MATLAB 代码。在此示例中，请在名为 MagicProject 的新文件夹中创建一个名为 magicsquare.m 的 MATLAB 函数。

function y = magicsquare(x)
y = magic(x);

在 MATLAB 命令提示符下，输入 magicsquare(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

创建工程和编译任务

使用 .NET 程序集编译器创建 .NET 程序集的编译器任务。编译器任务允许您为特定部署目标编译工程中的文件。

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

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

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

编辑器中打开了一个名为 DotNETAssembly1 的新编译任务。

您可以通过打开编译器任务管理器或转到管理任务选项卡并创建一个新的编译器任务来创建更多 .NET 编译器任务或为其他部署目标打包代码。

指定编译选项

在打包之前，您可以为 .NET 组件及其安装程序指定选项，以自定义构建和打包过程。例如，您可以混淆处理 MATLAB 代码，或指定在生成的安装程序中包含 MATLAB Runtime 的方法。

将 MATLAB 函数添加到 .NET 程序集。所有文件必须位于工程根文件夹中才能添加到工程中。在此示例中，在编译器任务的导出的函数部分，点击添加导出的函数，然后选择 magicsquare.m。在“工程”面板中，该文件现在带有标签 Design 和 Exported Function File。

在 .NET 程序集信息部分，将字符串 MyDotNetAssembly 替换为您的 .NET 程序集名称，即 magicsquarelib。

要为生成的文件选择不同的输出位置，请更新输出位置部分中的路径。

在 .NET API 选择部分，选择用于在 .NET 应用程序与 MATLAB 函数之间交换数据的 API。在此示例中，请选择 mwArray API。有关详细信息，请参阅选择 .NET 部署选项。

创建示例代码（可选）

MATLAB Compiler SDK 可以生成示例 .NET 代码，演示如何调用您导出的 MATLAB 函数。您可以使用示例来实现您自己的应用程序或者测试编译后的工件。如果您编写自己的 .NET 应用程序代码，可以在打包 MATLAB 函数后将其移动到适当的目录中。有关详细信息，请参阅创建示例代码来调用导出函数。

要创建一个示例 MATLAB 文件，请点击示例部分中的创建新示例。选择文件 magicsquare.m。一个 MATLAB 实时脚本已为您打开，供您编辑。在编辑采样输入下，输入值 5，然后保存文件。文件 sampleFiles\magicsquareSample1.mlx 被添加到任务的示例部分。

查看代码和打包 .NET 程序集

要查看包含有关构建和打包组件的说明的代码，请点击导出编译脚本旁边的箭头，然后选择显示代码。在右侧，一个窗口显示了一个部署脚本，其中包含与您的构建选项相对应的 compiler.build.dotNETAssembly 和 compiler.package.installer 函数。您可以通过点击导出编译脚本按钮将此代码转换为 MATLAB 脚本文件。运行生成的构建脚本与点击编译和打包按钮等效。

要创建 .NET 组件和安装程序，请点击编译和打包。要仅创建 .NET 组件，请点击编译和打包旁边的箭头，然后选择编译。

编译器会在工程文件夹中的 <compiler_task_name>/output 文件夹中生成文件。build 子文件夹包含 .NET 程序集，而 package 子文件夹包含您的程序集的安装程序以及 MATLAB 运行时。要为生成的文件选择不同的输出位置，请更新输出位置部分中的路径。

如果您创建了安装程序，package 子文件夹中包含您的共享库文件的安装程序以及 MATLAB 运行时。

将 .NET 程序集集成到 .NET 应用程序中

创建 .NET 程序集后，在您首选的 .NET 开发环境中编写 .NET 应用程序的源代码。有关详细信息，请参阅设置 .NET 开发环境。

如果您在打包前创建了示例代码，MATLAB Compiler SDK 会在 samples 文件夹中生成一个名为 magicsquareSample1.cs 的示例 C# .NET 应用程序。

 magicsquareSample1.cs

using System;
using System.Collections.Generic;
using System.Text;
using MathWorks.MATLAB.NET.Arrays;
using MathWorks.MATLAB.NET.Utility;
using magicsquarelib;

/// <summary>
/// Sample driver code that integrates a compiled MATLAB function
/// generated by MATLAB Compiler SDK
///
/// Refer to the MATLAB Compiler SDK documentation for more
/// information.
/// </summary>
class magicsquareSample1 {
    static Class1 Class1Instance;

    static void Setup() {
        Class1Instance = new Class1();
    }

    /// <summary>
    /// Example of using the var function.
    /// </summary>
    public static void magicsquareSample() {
        double xInData = 5.0;
        MWNumericArray yOut = null;
        Object[] results = null;
        try {
            MWNumericArray xIn = new MWNumericArray(xInData);
            results = Class1Instance.magicsquare(1, xIn);
            if (results[0] is MWNumericArray) {
                yOut = (MWNumericArray) results[0];
            }
            Console.WriteLine(yOut);
        } catch (Exception e) {
            Console.WriteLine(e);
        }
    }

    /// <summary>
    /// The main entry point for the application.
    /// </summary>
    static void Main(string[] args) {
        try {
            Setup();
        } catch (Exception e) {
            Console.WriteLine(e);
            Environment.Exit(1);
        }
        try {
            magicsquareSample();
        } catch (Exception e) {
            Console.WriteLine(e);
            Environment.Exit(1);
        }
    }
}

该应用程序执行以下操作：

有关使用 MWArray API 的更多详细信息，请参阅使用 MWArray API 进行数据编组。

编写源代码后，使用 Microsoft^® Visual Studio^® 构建并运行您的 .NET 应用程序。

要在 MATLAB 外部运行.NET 应用程序，您必须安装 MATLAB 运行时。有关详细信息，请参阅关于 MATLAB Runtime。如果您使用编译和打包创建了安装程序，该安装程序包含与用于编译 .NET 程序集的 MATLAB 版本相匹配的 MATLAB 运行时版本。

要部署 .NET 应用程序，请将代码存档和可执行文件 .exe 分发给最终用户。