Build .NET Core Application That Runs on Linux and macOS
Supported Platform: Windows® (Authoring), Linux® (Execution), and macOS (Execution).
This example shows how to create a .NET assembly using the Library Compiler and integrate it into a .NET Core application that can run on Linux or macOS.
Create a new work folder that is visible to the MATLAB® search path. This example uses
C:\Workas the new work folder.
Install MATLAB Runtime on Windows and on additional platforms where you plan on running your .NET Core application. For details, see Install and Configure MATLAB Runtime.
For Linux and macOS platforms, after installing MATLAB Runtime, you need to set the
DYLD_LIBRARY_PATHenvironment variables respectively. For more information, see Set MATLAB Runtime Path for Deployment.
Verify that you have Visual Studio® and .NET Core 2.0 or higher installed. If you have version 15.8.2 of Visual Studio 2017 installed, then you do not need to install .NET Core 2.0 or higher separately.
Create .NET Assembly
Package the function into a .NET assembly using the Library Compiler app.
Alternatively, if you want to create a .NET assembly from the MATLAB command window using a programmatic approach, see
Create a new MATLAB file named
mymagic.mwith the following code in the work folder:
function out = mymagic(in) out = magic(in);
libraryCompilerat the MATLAB command line to launch the Library Compiler app.
In the TYPE section of the toolstrip, select
.NET Assembly, and in the EXPORTED FUNCTIONS section, click the Add button to add the file
mymagic.mto the project.
In the Library information section, name the library
Double-click the class
Class1and rename it to
Save the deployment project with the project name
Select Package to create a .NET assembly. For information about the created files, see Files Generated After Packaging MATLAB Functions.
Create .NET Core Application
Open the command prompt in Windows and navigate to the folder
At the command line, type:
dotnet new console --name MyDotNetCoreApp
This creates a folder named
MyDotNetCoreAppthat has the following contents:
Program.csC# source file
Open the project file in a text editor.
<Project Sdk="Microsoft.NET.Sdk"> <PropertyGroup> <OutputType>Exe</OutputType> <TargetFramework>netcoreapp2.0</TargetFramework> </PropertyGroup> </Project>
Add the following references to the project using the
.NET assembly file
MyMatrixFunctions.dllcreated by the Library Compiler app
MWArray.dll, which is located in
Once you add the references, your project file should resemble the following:
<Project Sdk="Microsoft.NET.Sdk"> <PropertyGroup> <OutputType>Exe</OutputType> <TargetFramework>netcoreapp2.2</TargetFramework> </PropertyGroup> <ItemGroup> <Reference Include="MyMatrixFunctions"> <HintPath>C:\work\MyMatrixFunctions\for_redistribution_files_only\MyMatrixFunctions.dll</HintPath> <!--Path to .NET Assembly created by Library Compiler app--> </Reference> <Reference Include="MWArray"> <HintPath>C:\Program Files\MATLAB\MATLAB Runtime\R2023a\toolbox\dotnetbuilder\bin\win64\v4.0\MWArray.dll</HintPath> <!--Path to MWArray.dll in the MATLAB Runtime--> </Reference> </ItemGroup> </Project>
Open the C# source file
Program.csand replace the existing code with the following code:
At the command line, build your .NET Core project by typing:
dotnet build MyDotNetCoreApp.csproj
At the command line, run your application by typing:
dotnet run -- 3
The application displays a 3-by-3 magic square.
Publish the project as a self-contained deployment to execute the application on either Linux or macOS.
To publish to Linux, type the following command on a single line:
dotnet publish --configuration Release --framework netcoreapp2.2 --runtime linux-x64 --self-contained true MyDotNetCoreApp.csproj
To publish to macOS, type the following command on a single line:
dotnet publish --configuration Release --framework netcoreapp2.2 --runtime osx.10.11-x64 --self-contained true MyDotNetCoreApp.csproj
Run .NET Core Application on Linux
C:\Work\MyDotNetCoreApp\binon Windows to
~/Workon a Linux or macOS machine.
On the Linux machine, verify that you have installed MATLAB Runtime and set up your library path environment variable. For more information, see Prerequisites.
Open a command shell and navigate to:
Run the .NET Core application by typing:
Magic square of order 3 8 1 6 3 5 7 4 9 2 Magic square as native array: Element(0,0)= 8 Element(0,1)= 1 Element(0,2)= 6 Element(1,0)= 3 Element(1,1)= 5 Element(1,2)= 7 Element(2,0)= 4 Element(2,1)= 9 Element(2,2)= 2