Main Content

このページの翻訳は最新ではありません。ここをクリックして、英語の最新版を参照してください。

.NET アセンブリの生成と .NET アプリケーションのビルド

サポートされるプラットフォーム: Windows®

この例では、ライブラリ コンパイラ アプリを使用して MATLAB® 関数用の .NET アセンブリを作成する方法を示します。生成されたパッケージは、アプリケーションへの統合を担当する開発者に渡すことができます。また、この例では、.NET アプリケーションから .NET アセンブリを呼び出す方法も示します。MATLAB のライセンス コピーがターゲット システムにインストールされている必要はありません。

MATLAB で関数を作成

MATLAB で、パッケージ化する MATLAB コードを調べます。この例では、matlabroot\toolbox\dotnetbuilder\Examples\VSVersion\NET\MagicSquareExample\MagicSquareComp にある makesquare.m を開きます。

 makesquare.m

MATLAB コマンド プロンプトで、makesquare(5) と入力します。

出力は以下のようになります。

    17    24     1     8    15
    23     5     7    14    16
     4     6    13    20    22
    10    12    19    21     3
    11    18    25     2     9

ライブラリ コンパイラ アプリを使用して .NET アセンブリを作成

  1. [MATLAB アプリ] タブで、[アプリ] セクションの右端にある矢印をクリックします。[アプリケーション配布] で、[ライブラリ コンパイラ] をクリックします。

    または、MATLAB コマンド プロンプトで以下を入力して、[ライブラリ コンパイラ] アプリを開きます。

    libraryCompiler

  2. ツールストリップの [タイプ] セクションで、[.NET アセンブリ] をクリックします。

    ライブラリ コンパイラ アプリのプロジェクト ウィンドウで、配布する MATLAB アプリケーションのファイルを指定します。

    1. ツールストリップの [エクスポートする関数] セクションで、 をクリックします。

    2. [ファイルの追加] ウィンドウで、サンプルのフォルダーを参照し、パッケージ化する関数を選択します。[開く] をクリックします。

    エクスポートする関数ファイルのリストに関数が追加されます。同じアプリケーションに複数のファイルをパッケージ化するには、この手順を繰り返します。

    この例では、matlabroot\toolbox\dotnetbuilder\Examples\VSVersion\NET\MagicSquareExample\MagicSquareComp に移動して makesquare.m を選択します。

  3. ツールストリップの [パッケージ化オプション] セクションで次のオプションのいずれかを選択して、生成されるアプリケーションに MATLAB Runtime インストーラーを含めるかどうかを決定します。

    • ランタイムを Web からダウンロードMATLAB Runtime をダウンロードして配布された MATLAB アプリケーションと共にインストールするインストーラーを生成します。インストーラーのファイル名を指定できます。

    • ランタイムをパッケージに含めるMATLAB Runtime インストーラーを含むアプリケーションを生成します。インストーラーのファイル名を指定できます。

      メモ

      このオプションを初めて選択したときに、MATLAB Runtime インストーラーをダウンロードするように求めるメッセージが表示されます。

アセンブリ ファイル設定の指定

  1. [ライブラリ名] フィールドに、アセンブリの名前として makesquare が自動的に入力されます。この名前を MagicSquareComp に変更します。同じ名前が、アセンブリの実装時にも使用されます。

  2. makesquare.m で定義された関数が Class1 にマッピングされていることを確認します。

  3. サンプル .NET ドライバー ファイルを生成するための MATLAB ファイルを追加します。.NET ドライバー ファイルはアセンブリの作成に必須ではありませんが、.NET アプリケーションのビルドの方法を示すために使用します。

    [サンプル] セクションで、[新規サンプルの作成] を選択して makesquare.m をクリックします。MATLAB ファイルが編集用に開きます。アプリケーションの必要に応じて入力変数を定義し、ファイルを保存して [ライブラリ コンパイラ] アプリに戻ります。詳細と制限については、サンプル ドライバー ファイルの作成を参照してください。

アプリケーションとその外観のカスタマイズ

次のように、インストーラーのカスタマイズ、アプリケーションのカスタマイズ、アプリケーションに関する情報の追加を実行できます。

  • ライブラリ情報 — 配布されるアプリケーションに関する情報。また、アプリケーション アイコンとスプラッシュ スクリーンを変更して、アプリケーションの外観をカスタマイズすることもできます。生成されるインストーラーはこの情報を使用して、インストールされるアプリケーションのメタデータを入力します。インストーラーのカスタマイズを参照してください。

  • 追加インストーラー オプション — 生成されるインストーラーの既定のインストール パスと、カスタム ロゴの選択。インストール パスの変更を参照してください。

  • ライブラリの実行に必要なファイル — 生成されるアプリケーションを実行するために必要な追加ファイル。これらのファイルは、生成されるアプリケーション インストーラーに含められます。コンパイラ プロジェクトの必須ファイルの管理を参照してください。

  • エンド ユーザー用にインストールされるファイル — アプリケーションと共にインストールされるファイル。これらのファイルには、以下が含まれます。

    • 生成された readme.txt

    • ターゲット プラットフォーム用に生成される実行可能ファイル

    アプリケーションと共にインストールするファイルの指定を参照してください。

  • ランタイム追加設定 — 生成される実行可能ファイルを制御するためのプラットフォーム固有のオプション。ランタイム追加設定を参照してください。

アプリケーションのパッケージ化

  1. パッケージ化されたアプリケーションを生成するには、[パッケージ化] をクリックします。

    [プロジェクトを保存] ダイアログ ボックスで、プロジェクトを保存する場所を指定します。

  2. [パッケージ] ダイアログ ボックスで、[プロセスが完了したら出力フォルダーを開く] が選択されていることを確認します。

    パッケージ化プロセスが完了したら、生成された出力を調べます。

    • ターゲット フォルダーの場所に for_redistributionfor_redistribution_files_onlyfor_testing の 3 つのフォルダーが生成されます。

      これらのフォルダーに生成されるファイルの詳細については、MATLAB 関数のパッケージ化後に生成されるファイルを参照してください。

    • PackagingLog.txtMATLAB Compiler™ により生成されたログ ファイル。

.NET アプリケーションのビルド

.NET アセンブリ ファイルの作成後、.NET アプリケーションからこれを呼び出すことができます。作成する .NET アプリケーションでは、パッケージ化の際に生成されたサンプル .NET ドライバー コードを使用します。この .NET ドライバー コードは .NET アセンブリ ファイルを呼び出し、以前のセットアップ手順で選択したサンプル MATLAB ファイルを基にしています。

これらの手順は、for_redistribution_files_only フォルダーの GettingStarted.html ファイルでも説明しています。開始する前に、MATLAB Runtime のインストールと構成が完了していて、Microsoft® Visual Studio® がインストールされていることを確認してください。

  1. .NET アセンブリを for_redistribution フォルダーからインストールします。

    生成された共有ライブラリとサポート ファイルは、for_testing フォルダーにあります。

  2. Microsoft Visual Studio を開いてプロジェクトを作成します。この例では、[MainApp] という名前の C# コンソール アプリケーションを作成し、アセンブリ ファイル MagicSquareComp.dll への参照を作成します。

    コンポーネントをインストールした場所に作成されるアプリケーション フォルダーにアセンブリがあることを確認してください。

  3. MWArray API への参照を作成します。MATLAB Runtime 内の API の場所は、次のとおりです。

    matlabroot\MATLAB Runtime\v99\toolbox\dotnetbuilder\bin\arch\version\MWArray.dll

  4. [ビルド][構成マネージャー] に移動し、プラットフォームを [Any CPU] から [x64] に変更します。

  5. 生成されたサンプル .NET ドライバー コード makesquareSample1.csfor_redistribution_files_only\samples フォルダーからプロジェクトへコピーして保存します。

  6. コードの記述が完了したら、Microsoft Visual Studio を使用してコードをビルドし、実行します。

参考

| |

関連するトピック