设置 .NET 开发环境
要将 MATLAB® 代码集成到 .NET 应用程序中,请首先使用 MATLAB 桌面编写您的 MATLAB 代码。然后,利用 MATLAB Compiler SDK™ 生成 .NET 组件。最后,在您首选的 C# 开发环境(包括 Windows® 和 macOS 上的文本编辑器以及 .NET SDK 命令行 API 或 Microsoft® Visual Studio®)中完成集成过程。
您需要在设置中包含的文件取决于您使用的是现代版 MATLAB Data API for .NET 还是旧版 MWArray API。
.NET 命令行 API
使用 .NET SDK 命令行界面 (CLI) 和代码编辑器将 MATLAB 代码集成到 .NET 应用程序中。您必须使用 .NET 6.0 或更高版本。您可以在系统命令提示符下键入 dotnet --info
来验证是否已安装 .NET 6.0。有关详细信息,请参阅 .NET CLI 概述。
MATLAB Data API for .NET
将以下程序集依赖项添加到您的工程中:
MathWorks.MATLAB.Runtime.dll
MathWorks.MATLAB.Types.dll
指向 MathWorks 程序集的 Linux 和 macOS 路径
编辑工程文件 (.csproj
) 并使用 <ItemGroup>
标记添加上述引用。例如:
<Project Sdk="Microsoft.NET.Sdk">
<PropertyGroup>
<OutputType>Exe</OutputType>
<TargetFramework>net5.0</TargetFramework>
</PropertyGroup>
<ItemGroup>
<Reference Include="MathWorks.MATLAB.Runtime">
<HintPath>C:\Program Files\MATLAB\MATLAB Runtime\R2025a\extern\dotnet\netstandard2.0\MathWorks.MATLAB.Runtime.dll</HintPath>
</Reference>
<Reference Include="MathWorks.MATLAB.Types">
<HintPath>C:\Program Files\MATLAB\MATLAB Runtime\R2025a\extern\dotnet\netstandard2.0\MathWorks.MATLAB.Types.dll</HintPath>
</Reference>
</ItemGroup>
</Project>
MWArray API
将以下程序集依赖项添加到您的工程中:
MWArray.dll
Microsoft Visual Studio
如果您使用 Visual Studio 进行集成,请首先验证您是否已安装 Microsoft Visual Studio 2022(v17.0 或更高版本)。
MATLAB Data API for .NET
从 Solution Explorer 中添加上面列出的 MathWorks® 程序集:
在 Solution Explorer 中,右键点击 Dependencies 节点,然后选择 Add Project Reference。
在 Reference Manager 中浏览并添加上述 MathWorks 程序集依赖项。
设置 PATH 环境变量
在 Visual Studio 中执行 C# 应用程序之前,请确保正确设置 PATH
环境变量以引用 MATLAB 或 MATLAB Runtime 安装。以下是在 Visual Studio 中设置 PATH
环境变量的方法:
在 Visual Studio 中,右键点击 Solution Explorer 中的工程,然后点击 Properties。
导航到 Debug > General,然后选择 Open debug launch profiles UI。
在 Launch Profiles 窗口的 Environment variables 下,设置您的
PATH
:对于 MATLAB:
PATH=C:\Program Files\MATLAB\R2025a\runtime\win64
对于 MATLAB Runtime:
PATH=C:\Program Files\MATLAB\MATLAB Runtime\R2025a\runtime\win64
MWArray API
从以下位置之一添加 MWArray.dll
程序集作为引用。
注意
您可以针对用于生成 .NET 工件的已安装版本的 MATLAB 或针对 MATLAB Runtime 的安装来测试 .NET 应用程序。但是,在部署期间,您必须使用 MATLAB Runtime。