.NET 엔진 프로그램 빌드를 위한 요구 사항

엔진 애플리케이션을 빌드하기 위한 .NET 환경을 설정하려면 다음을 수행하십시오.

• 지원되는 버전의 .NET이 설치되어 있는지 확인합니다.

• 환경 변수를 설정합니다.

• .NET 코드를 빌드하고 실행합니다.

지원되는 버전의 .NET

지원되는 버전의 .NET을 사용하여 엔진 애플리케이션을 빌드합니다. 버전 정보는 다른 언어에 대한 MATLAB 인터페이스를 참조하십시오. https://dotnet.microsoft.com/download에서 .NET SDK와 .NET Runtime을 모두 설치하십시오.

런타임 환경

애플리케이션을 실행하려면 다음 환경 변수 중 하나를 지정된 경로로 설정합니다.

운영 체제	변수	경로
Windows®	PATH	matlabroot\extern\bin\win64
Apple Silicon이 탑재된 macOS	DYLD_LIBRARY_PATH	matlabroot/extern/bin/maca64
Intel®이 탑재된 macOS	DYLD_LIBRARY_PATH	matlabroot/extern/bin/maci64
Linux®	LD_LIBRARY_PATH	matlabroot/extern/bin/glnxa64:matlabroot/sys/os/glnxa64

CLI에서 .NET 프로젝트를 빌드하고 실행하기

.NET CLI(명령줄 인터페이스)와 코드 편집기를 사용하여 .NET 애플리케이션을 만듭니다. 자세한 내용은 Microsoft^® 문서의 .NET CLI Overview를 참조하십시오. MATLAB^®에서 제공되는 C# 예제를 사용하는 방법은 .NET 개발 환경 테스트하기 항목을 참조하십시오.

1. 운영 체제 명령 프롬프트를 열고 쓰기 가능한 폴더로 이동합니다.

2. 명령줄에서 런타임 환경 변수를 설정합니다.

3. 프로젝트 MyApp을 만듭니다.

   dotnet new console --name MyApp

   이 명령은 다음을 포함하는 폴더 MyApp을 만듭니다.

   • obj 폴더

   • MyApp.csproj 프로젝트 파일

   • Program.cs C# 소스 파일

4. 텍스트 편집기에서 프로젝트 파일을 열고, <ItemGroup> 태그를 사용하여 프로젝트에 다음 참조를 추가합니다. 파일은 fullfile(matlabroot,"extern","dotnet","netstandard2.0")으로 정의된 폴더에 있습니다.

   • MathWorks.MATLAB.Engine

   • MathWorks.MATLAB.Types

5. <PackageReference> 태그를 사용해 Microsoft.CSharp에 대한 참조를 추가하여 dynamic 키워드를 사용할 수 있도록 설정합니다.

6. <TargetFramework> 태그를 사용하여 타깃 프레임워크가 지원되는 버전(예: net5.0 또는 net6.0)인지 확인합니다. 버전 정보는 다른 언어에 대한 MATLAB 인터페이스를 참조하십시오.

7. 프로젝트 파일은 다음과 비슷할 것입니다.

   <Project Sdk="Microsoft.NET.Sdk">
   
     <PropertyGroup>
       <OutputType>Exe</OutputType>
       <TargetFramework>net5.0</TargetFramework>
     </PropertyGroup>
   
     <ItemGroup>
       <!-- Enables interop between .NET and MATLAB -->
       <Reference Include="MathWorks.MATLAB.Types" >
         <HintPath>$(matlabroot)/extern/dotnet/netstandard2.0/MathWorks.MATLAB.Types.dll</HintPath>
       </Reference>
       
       <!-- Provides an interface to MATLAB Engine API -->
       <Reference Include="MathWorks.MATLAB.Engine" >
         <HintPath>$(matlabroot)/extern/dotnet/netstandard2.0/MathWorks.MATLAB.Engine.dll</HintPath>
       </Reference>
       
       <!-- Provides an interface to MATLAB Engine API Exceptions -->
       <Reference Include="MathWorks.MATLAB.Exceptions" >
         <HintPath>$(matlabroot)/extern/dotnet/netstandard2.0/MathWorks.MATLAB.Engine.dll</HintPath>
       </Reference>
   
       <!-- Enables using the 'dynamic' keyword -->
       <PackageReference Include="Microsoft.CSharp" Version="4.7.0" />
     </ItemGroup>
   </Project>

8. C# 소스 파일 Program.cs를 열고 기존 코드를 다음 코드로 바꿉니다.

    Program.cs

   // *******************************************************************************
   //
   // Program.cs
   //
   // This example demonstrates how to use MATLAB .NET Assembly to build a simple 
   // component returning a magic square.
   //
   // Copyright 2022 The MathWorks, Inc.
   //
   // *******************************************************************************
   
   using System;
   using MathWorks.MATLAB.Engine;
   using MathWorks.MATLAB.Exceptions;
   using MathWorks.MATLAB.Types;
   
   namespace MathWorks.MATLAB.Engine.ConsoleExamples {
       public class Program {
    
           // The main entry point for the application.
           static void Main() {
               using (dynamic matlab = MATLABEngine.StartMATLAB()) {
                   double xIn = 5.0;
                   double [,] results = matlab.magic(xIn);
                   RunOptions opts = new RunOptions() { Nargout = 0 };
                   matlab.disp(opts, "Hello, MATLAB!");
                   for (int i = 0; i < results.GetLength(0); i++) {
                       for (int j = 0; j < results.GetLength(1); j++) {
                           Console.Write("{0} ", results[i, j]);
                       }
                       Console.WriteLine();
                   }
               }
           }
       }
   }

9. 명령줄에서 matlabroot를 지정하여 C# 프로젝트를 빌드합니다. 예를 들어, matlabroot가 C:\Program Files\MATLAB\R2022b이면 다음과 같이 입력합니다.

   cd MyApp
   dotnet build /p:matlabroot="C:\Program Files\MATLAB\R2022b" MyApp.csproj

10. 명령줄에서 애플리케이션을 실행합니다.

    dotnet run --no-build

    애플리케이션에 마방진이 표시됩니다.

Microsoft Visual Studio에서 .NET 프로젝트를 빌드하고 실행하기

대화형 방식의 명령줄을 사용하여 .NET 애플리케이션을 생성하는 방법 대신에, Microsoft Visual Studio^®를 사용하여 애플리케이션을 만들 수 있습니다.

1. Visual Studio에서 .NET 5.0 C# 프로젝트 MyApp을 만듭니다. 자세한 내용은 Microsoft 문서에서 Create a .NET console application using Visual Studio의 Create the app 섹션을 참조하십시오.

2. Visual Studio의 솔루션 탐색기에서 프로젝트 이름을 마우스 오른쪽 버튼으로 클릭하고 추가 > 프로젝트 참조를 선택합니다. 참조 관리자 창에서 찾아보기를 클릭하고 다음 참조를 추가합니다. 파일은 fullfile(matlabroot,"extern","dotnet","netstandard2.0")으로 정의된 폴더에 있습니다.

   • MathWorks.MATLAB.Engine

   • MathWorks.MATLAB.Types

3. C# 소스 파일 Program.cs를 열고 기존 코드를 이전 CLI에서 .NET 프로젝트를 빌드하고 실행하기 섹션의 C# 소스 파일 열기 단계에 제공된 코드로 바꿉니다.

4. 애플리케이션을 빌드하고 실행합니다.

관련 항목

• .NET 개발 환경 테스트하기