プロジェクトを使用したカスタムタスクの実行

この例では、プロジェクトにより管理された一連のファイルにカスタムタスクを適用する方法を示します。この例のカスタムタスクでは、プロジェクト内の Simulink® モデルを解析し、各モデルのブロック数をレポートします。

プロジェクトを開く

サンプルプロジェクトを開き、プロジェクトオブジェクトを作成します。

proj = openProject("airframe");

カスタムタスクの選択

1. [プロジェクト] タブで、下矢印をクリックして [ツール] ギャラリーを展開します。[プロジェクトチェック] で、[カスタムタスク] をクリックします。

MATLAB® 関数でカスタムタスクを定義します。Airframe プロジェクトの例では、例のカスタムタスクが "custom_tasks" フォルダーに含まれます。

2. [カスタムタスク] メニューには、使用可能なカスタムリストが示されます。

カスタムタスクを表示、編集、および作成するには、[プロジェクト] タブで、下矢印をクリックして [ツール] ギャラリーを展開します。[プロジェクトチェック] で、[カスタムタスク] をクリックします。[カスタムタスク] ダイアログボックスで [管理] をクリックします。

3. "Analyze Model Files" カスタムタスクを選択します。

選択したカスタムタスクの関数名が [カスタムタスク] フィールドに表示されます。"analyzeModelFiles" の例では、カテゴリ "Metrics" からのラベルがプロジェクトの各モデルファイルに追加されます。このカテゴリのラベルには数値データが含まれます。カスタムタスクは、各モデルのブロック数をカウントし、この数値をラベルに付加します。

カスタムタスクに含めるファイルの選択

[カスタムタスク] ダイアログボックスの [含める] 列で、すべてのモデルファイルのチェックボックスが選択されていることを確認します。

カスタムタスクの実行

カスタムタスクを実行するために [タスクの実行] をクリックします。

選択したファイルの結果は、ダイアログボックスの下部にある [結果] ペインに表示されます。これは、返された結果が長い場合や、返された結果に HTML マークアップが含まれている場合に役立ちます。

次の例は、いくつかのモデルでカスタムタスクを実行した後のダイアログボックスを示しています。歯車アイコンボタンを使用して、表示する列をカスタマイズすることもできます。

既存のカスタムタスクの編集

カスタムタスクは MATLAB 関数です。MATLAB エディターでカスタムタスクを編集します。たとえば、変更未保存 (ダーティ) のモデルファイルを保存するだけでなく、データをもつラベルをプログラムによって追加するよう、カスタムタスクを変更します。

1. 次の MATLAB コードを実行して、Metrics カテゴリと Block Count ラベルをプロジェクトに作成します。

category = createCategory(proj,'Metrics','double');

2. "analyzeModelFiles.m" をダブルクリックして、このファイルを MATLAB エディターで編集します。

3. sprintf コマンドの直後に以下の行を追加します。

[~, compileStats] = sldiagnostics(name,'CompileStats');
addLabel(projectFile, 'Metrics','CPU Compile Time',sum([compileStats.Statistics.CPUTime]));

その他の MATLAB 関数を用いる場合と同様、MATLAB エディターを使用して、ブレークポイントを設定したり、カスタムタスク関数をデバッグしたりすることができます。

カスタムタスクを再実行すると、CPU Compile Time ラベルがコンパイル可能な各モデルファイルに追加され、モデルのすべてのコンパイルフェーズの合計時間を示すラベルにデータが付加されます。コンパイルできないモデルは、カスタムタスクのレポートに "Failed to analyze file" として表示され、詳細がコマンドウィンドウに警告として表示されます。カスタムタスク "analyzeModelFiles.m" を調べてエラーの処理方法を確認します。

新しいメトリクスデータを表示するには、カスタムタスクレポートに "Metrics" 列を表示するか、プロジェクト "ファイル" ビューを確認します。

新しいカスタムタスクの作成

新しい MATLAB 関数を作成して新規カスタムタスクを作成します。カスタムタスクは以下でなければなりません。

MATLAB パス上に保存される。
単一の入力引数である、ファイルへの絶対パスを受け入れる。
単一の出力引数を返す。

カスタムタスクを作成するには、[プロジェクト] タブで、下矢印をクリックして [ツール] ギャラリーを展開します。[プロジェクトチェック] で、[カスタムタスク] をクリックします。[カスタムタスク] ダイアログボックスで [管理] をクリックします。[カスタムタスクの管理] ダイアログボックスで [追加] をクリックして、正しい関数シグネチャをもつカスタムタスクを作成するための手順の説明が記載された新しいファイルを開きます。

1. [追加]、[新規関数を使用して追加] を選択します。

ファイルダイアログが開くので、新しいカスタムタスクを作成する場所を選択します。カスタムタスクを実行するには、MATLAB パス上に保存しなければなりません。

2. ファイル名を指定し、ファイルをプロジェクト内の "custom_tasks" フォルダーに保存します。

MATLAB エディターは、簡単なカスタムタスク例が事前設定されたファイルを開きます。

3. 新しいカスタムタスクを作成するには、例のカスタムタスク関数の内容を編集して保存します。