.NET エンジン プログラムのビルド要件

エンジン アプリケーションのビルドに使用する .NET 環境を設定するには、次を行います。

• サポートされているバージョンの .NET があることを確認する。

• 環境変数を設定する。

• .NET コードをビルドして実行する。

サポート対象の .NET のバージョン

サポートされているバージョンの .NET を使ってエンジン アプリケーションをビルドします。バージョンの情報については、MATLAB Interfaces to Other Languages を参照してください。https://dotnet.microsoft.com/download から .NET SDK と .NET Runtime の両方をインストールします。

ランタイム環境

アプリケーションを実行するには、以下の環境変数のいずれかを、指定されているパスに設定します。

オペレーティング システム	変数	パス
Windows®	PATH	matlabroot\extern\bin\win64
Apple シリコン搭載の 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 の概要を参照してください。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> タグを使用して、ターゲット フレームワークがサポートされているバージョンであることを確認します。バージョンの情報については、MATLAB Interfaces to Other Languages を参照してください。

7. プロジェクト ファイルは次のようになります。

   <Project Sdk="Microsoft.NET.Sdk">
   
     <PropertyGroup>
       <OutputType>Exe</OutputType>
       <TargetFramework>net6.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>
       
       <!-- 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 で、MyApp という名前の .NET 5.0 C# プロジェクトを作成します。詳しくは、Microsoft ドキュメンテーションの Visual Studio を使用して .NET コンソール アプリケーションを作成する内の「アプリを作成する」セクションを参照してください。

2. Visual Studio の [ソリューション エクスプローラー] でプロジェクト名を右クリックし、[追加]、[プロジェクト参照] を選択します。[参照マネージャー] ウィンドウで [参照] をクリックして以下の参照を追加します。ファイルは fullfile(matlabroot,"extern","dotnet","netstandard2.0") で定義されているフォルダーにあります。

   • MathWorks.MATLAB.Engine

   • MathWorks.MATLAB.Types

3. C# ソース ファイル Program.cs を開き、既存のコードを前のCLI からの .NET プロジェクトのビルドと実行のセクションの C# ソース ファイルを開く手順で示されているコードに置き換えます。

4. アプリケーションをビルドして実行します。

関連するトピック

• .NET 開発環境のテスト