.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 開発環境のテストを参照してください。

オペレーティングシステムのコマンドプロンプトを開き、書き込み可能なフォルダーに移動します。
コマンドラインで、ランタイム環境変数を設定します。
プロジェクト MyApp を作成します。
```
dotnet new console --name MyApp
```
このコマンドにより、以下が含まれている MyApp という名前のフォルダーが作成されます。
- obj フォルダー
- MyApp.csproj プロジェクトファイル
- Program.cs C# ソースファイル
プロジェクトファイルをテキストエディターで開き、<ItemGroup> タグを使用してプロジェクトに以下の参照を追加します。ファイルは fullfile(matlabroot,"extern","dotnet","netstandard2.0") で定義されているフォルダーにあります。
- MathWorks.MATLAB.Engine
- MathWorks.MATLAB.Types
<PackageReference> タグを使用して Microsoft.CSharp への参照を追加して、dynamic キーワードの使用を有効にします。
<TargetFramework> タグを使用して、ターゲットフレームワークが net5.0 や net6.0 などのサポートされているバージョンであることを確認します。バージョンの情報については、MATLAB Interfaces to Other Languages を参照してください。

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

<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>

C# ソースファイル Program.cs を開き、既存のコードを次のコードに置き換えます。

Program.cs

コマンドラインで、matlabroot を指定して、C# プロジェクトをビルドします。たとえば、matlabroot が C:\Program Files\MATLAB\R2022b の場合は、以下を入力します。
```
cd MyApp
dotnet build /p:matlabroot="C:\Program Files\MATLAB\R2022b" MyApp.csproj
```
コマンドラインでアプリケーションを実行します。
```
dotnet run --no-build
```
アプリケーションで魔方陣が表示されます。

Microsoft Visual Studio からの .NET プロジェクトのビルドと実行

.NET アプリケーションを作成する対話的なコマンドラインの方法の代わりに、Microsoft Visual Studio^® を使用してアプリケーションを作成できます。

Visual Studio で、MyApp という名前の .NET 5.0 C# プロジェクトを作成します。詳しくは、Microsoft ドキュメンテーションの Visual Studio を使用して .NET コンソールアプリケーションを作成する内の「アプリを作成する」セクションを参照してください。
Visual Studio の [ソリューションエクスプローラー] でプロジェクト名を右クリックし、[追加]、[プロジェクト参照] を選択します。[参照マネージャー] ウィンドウで [参照] をクリックして以下の参照を追加します。ファイルは fullfile(matlabroot,"extern","dotnet","netstandard2.0") で定義されているフォルダーにあります。
- MathWorks.MATLAB.Engine
- MathWorks.MATLAB.Types
C# ソースファイル Program.cs を開き、既存のコードを前のCLI からの .NET プロジェクトのビルドと実行のセクションの C# ソースファイルを開く手順で示されているコードに置き換えます。
アプリケーションをビルドして実行します。