.NET アセンブリ コンパイラ

デプロイする MATLAB プログラムを .NET アセンブリとしてパッケージ化する

R2025a 以降

このページをすべて展開する

説明

.NET アセンブリ コンパイラは MATLAB® プログラムを、.NET アプリケーションに統合できる .NET アセンブリにパッケージ化します。コンパイラ アプリで使用される対話型のメニューおよびダイアログ ボックスにより、仕様に合わせてカスタマイズされた compiler.build コマンドが作成されます。

コンパイラ アプリには次のような利点があります。

  • 単一の直感的なインターフェイスを使用して、デプロイ タスクを実行できる。

  • MATLAB プロジェクトでファイルを整理できる。

  • プロジェクトの状態がセッション間で維持される。

  • 事前に設定されたメニューから、以前保存したコンパイラ タスクを読み込むことができる。

  • 配布用にアプリケーションをインストーラーと共にパッケージ化できる。

詳細については、MATLAB コードのデプロイ用のターゲット固有のコンパイラ アプリを参照してください。

.NET アセンブリ コンパイラ アプリを開く

  • MATLAB ツールストリップ: [アプリ] タブの [アプリケーションのデプロイ] にあるアプリのアイコンをクリックします。

  • MATLAB コマンド プロンプト: dotNetAssemblyCompiler と入力します。

例

パラメーター

すべて展開する

エクスポートする関数

MATLAB 関数を実装するファイル。ファイルの拡張子は .m、.p、.mlx、.mexa64 のいずれかである必要があります。

プロジェクトに追加するすべてのファイルは、プロジェクトのルート フォルダーに配置する必要があります。デプロイ可能なアーカイブに MATLAB 関数を追加するには、[エクスポートする関数の追加] をクリックして MATLAB ファイルを選択します。[プロジェクト] パネルでは、選択したファイルに Design と Exported Function File というラベルが付けられます。

.NET アセンブリの情報

生成される .NET アセンブリの名前。

パッケージのバージョン番号。

アプリケーションの作成者の名前。

アプリケーション作成者の電子メール アドレス。

アプリケーションを作成した会社の名前。

パッケージの概要説明。文字ベクトルまたは string スカラーとして指定します。

パッケージの詳細な説明。文字ベクトルまたは string スカラーとして指定します。

出力場所

ビルド アーティファクトが生成されるフォルダーへのパス。

インストーラーが生成されるフォルダーへのパス。

  • このプロパティを有効にした場合、コンパイルされたアーティファクトにデバッグ シンボル情報が含まれます。このオプションによって、mbuild からシステム コンパイラに適切なデバッグ フラグも渡されます。このデバッグ オプションを使用すると、MATLAB Runtime の初期化、関数呼び出し、または終了ルーチンのいずれでエラーが発生したかを特定できる箇所まで戻ることができます。このオプションでは、外部デバッガーで MATLAB ファイルをデバッグすることはできません。

  • このプロパティを無効にした場合、デバッグ シンボルは含まれません。これは既定のオプションです。

ビルド設定

[.NET API の選択] セクションで、.NET アプリケーションと MATLAB 関数との間でデータを交換するために使用する API を選択します。

.NET デプロイ オプションの選択では、各オプションの機能についての理解と、これらの機能が開発要件にどのように合致するかの認識が重要になります。どちらのオプションにも、アプリケーション管理とデータ操作の両方を処理するための API の包括的なセットが用意されています。MathWorks® では、mwArray API よりも新しい MATLAB データ API を使用することをお勧めします。詳細については、Choose C++ Deployment Optionを参照してください。

このオプションを有効にした場合、デプロイ可能なアーカイブのフォルダー構造およびファイル名はエンド ユーザーに対して難読化され、.m、.mlapp、.p、.mat、MLX、SFX、および MEX ファイルに含まれているユーザー コードおよびデータはアーカイブ内のユーザー パッケージに配置されます。また、すべての .m ファイルがパッケージ化の前に P ファイルに変換されます。

実行時に、MATLAB コードとデータはファイル システムに抽出されるのではなく、ユーザー パッケージから直接復号化されて読み込まれます。MEX ファイルは、一時的にユーザー パッケージから抽出されてから、読み込まれます。

追加のファイル タイプをユーザー パッケージに手動で含めるには、それぞれのファイル タイプを個別の拡張子タグでファイル matlabroot/toolbox/compiler/advanced_package_supported_files.xml に追加します。

以下はサポートされて "いません"。

  • ver 関数

  • DLL などの外部ライブラリの呼び出し

  • アウトプロセスの MATLAB Runtime (MATLAB データ配列の C++ 共有ライブラリ)

  • アウトプロセスでの MEX ファイルの実行 (mexhost、feval、matlab.mex.MexHost)

  • R2023b より前: v7.3 以外の .mat ファイル

このオプションを有効にすることは、-j および -s を指定して mcc を使用するのと等価です。

このパラメーターを 'off' に設定した場合、デプロイ可能なアーカイブは難読化されません。これは既定の動作です。

.NET アセンブリの実行に必要なファイル

デプロイ可能なアーカイブに含めるサポート パッケージ。依存関係の分析プロセスにより、必要なサポート パッケージが自動的に検出され、含められます。指定されたサポート パッケージのみが含められます。インストールされている、または特定のファイルで使用されるサポート パッケージのリストを表示するには、compiler.codetools.deployableSupportPackages を参照してください。

デプロイ可能なアーカイブに含める追加のファイルとフォルダー。フォルダーの内容を追加するには、[フォルダーの追加] をクリックします。個々のファイルを追加するには、[ファイルの追加] をクリックします。

デプロイ可能なアーカイブに含める追加のファイル。[load や fopen などの関数への入力として提供されるデータ ファイルを自動的に含める] が無効になっていない限り、必要なデータ ファイルが依存関係の分析プロセスによって自動的に検出されて含まれます。

ファイルの解析結果を確認するには、[解析の表示] をクリックします。依存関係の分析プロセスを再度実行するには、[再解析] をクリックします。

デプロイ可能なアーカイブにデータ ファイルを自動的に含めます。

  • このプロパティを有効にした場合、特定の関数 (load や fopen など) への入力として指定したデータ ファイルは自動的にデプロイ可能なアーカイブに含められます。これは既定のオプションです。

  • このプロパティを無効にした場合、[カスタム要件] セクションでデータ ファイルをパッケージに追加する必要があります。

サンプル

サンプル MATLAB ファイルを生成および変更します。このファイルは、MATLAB のエクスポートされた関数を呼び出す方法を示す .NET コードにターゲット言語でコンパイルされます。

パッケージ化の際に含める MATLAB サンプル ファイルごとに、ターゲット言語のサンプル アプリケーションが samples という名前のフォルダーに生成されます。これらのサンプルはインストーラーにも含まれます。

記述済みの MATLAB スクリプトをアップロードするには、[既存のサンプルの追加] をクリックします。

新しい MATLAB サンプル ファイルを生成するには、[新規サンプルの作成] をクリックします。これにより、MATLAB スクリプトが開いて編集できます。パッケージ化後、生成されたサンプル コードはサンプル MATLAB スクリプトにあるものと同じ引数を使用して、エクスポートされた関数を呼び出します。

詳細については、Create Sample Code to Call Exported Functionを参照してください。

インストーラーの詳細

MATLAB Runtime の引き渡しオプション。次のいずれかとして指定します。

  • アプリケーションのインストール時に mathworks.com から MATLAB Runtime を取得します — アプリケーションのインストール時にインストーラーが MathWorks の Web サイトから MATLAB Runtime をダウンロードするオプション。このオプションは既定の動作です。

  • オフライン インストール用のアプリケーション インストーラーに MATLAB Runtime を含めます — アプリケーションのインストール時に MathWorks Web サイトに接続せずにインストールできるように、インストーラー内に MATLAB Runtime を含めるオプション。エンド ユーザーがインターネットにアクセスできない可能性があると考えられる場合は、このオプションを使用します。

  • MATLAB Runtime をアプリケーション インストーラーに含めません — アプリケーションのインストール時に MATLAB Runtime をインストールしないオプション。エンド ユーザーが別の方法を使用して MATLAB Runtime をインストールすると考えられる場合は、このオプションを使用します。 (R2024a 以降)

メモ

取得オプションと含めるオプションのいずれかを使用すると、完全な MATLAB Runtime がインストールされます。1 つ以上の特定の MATLAB Runtime アプリケーションを実行できる最小限の MATLAB Runtime インストーラーを作成するには、compiler.runtime.customInstaller を参照してください。 (R2024b 以降)

生成されたインストーラーの名前。

アプリケーションがインストールされるフォルダーへのパス。フォルダーはターゲット マシンの %ProgramFiles% フォルダー内にあります。

アプリケーションの使用に関する追加要件についてのメモ。

インストーラーのスプラッシュ スクリーンとして使用するイメージ ファイル。文字ベクトルまたは string スカラーとして指定します。スプラッシュ スクリーンのアイコンのサイズは 400 x 400 ピクセルに変更されます。

インストーラーのアイコンとして使用するイメージ ファイル。

インストーラーのロゴとして使用するイメージ ファイル。文字ベクトルまたは string スカラーとして指定します。ロゴのサイズは 112 x 290 ピクセルに変更されます。

バージョン履歴

R2025a で導入

すべて展開する

参考

関数