カスタムタスクの作成

カスタムタスクは、1 つ以上のファイルに対して一連の操作を実行できる MATLAB^® 関数です。カスタムタスク関数を作成して、プロジェクト内の選択した一連のファイルに対してカスタムタスクを実行できます。たとえば、カスタムタスクを作成して、すべてのコードファイルでエラーをチェックしたり、プロジェクトですべてのテストを実行することができます。

カスタムタスク関数の作成

カスタムタスク関数を作成するには、次の手順に従います。

[プロジェクト] タブで下矢印をクリックし、[ツール] ギャラリーを展開します。[プロジェクトチェック] で [カスタムタスク] をクリックします。[カスタムタスク] ダイアログボックスで [管理] をクリックします。
[追加] をクリックして、[新規関数を使用して追加] を選択します。既存のスクリプトをカスタムタスクとして追加する場合は、[既存の関数を使用して追加] を選択します。
スクリプトのファイル名を指定して、その新しいファイルを MATLAB パス上に保存します。MATLAB エディターは、カスタムタスク関数の例が含まれる新しいファイルを開きます。
各ファイルに対して目的のアクションが実行されるよう関数を編集します。ファイルの先頭にある手順を使用することで、正しい関数シグネチャを使用してカスタムタスクを作成することができます。カスタムタスクでは、ファイルへの絶対パスを 1 つの入力引数として受け入れ、1 つの出力引数を返さなければなりません。
たとえば、このカスタムタスク関数は関数 checkcode を使用して各ファイルのコードアナライザー情報を抽出します。
```
[~,~,ext] = fileparts(file);
switch ext
    case {'.m', '.mlx', '.mlapp'}
        result = checkcode(file, '-string');
    otherwise
        result = [];
end
```
ファイルを保存します。

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

カスタムタスクの実行

プロジェクト内の選択された一連のファイルに対してカスタムタスクを実行するには、次の手順に従います。

[プロジェクト] タブで下矢印をクリックし、[ツール] ギャラリーを展開します。[プロジェクトチェック] で [カスタムタスク] をクリックします。
テーブルの [含める] 列で、カスタムタスクの実行対象であるプロジェクトファイルを選択します。
テーブルの複数のファイルを一度に含めたり、除外するには、Shift キーまたは Ctrl キーを押して、ファイルを選択してから右クリックして [含める] または [除外] を選択します。カスタムタスク関数が操作対象のファイルを識別できる場合は、すべてのファイルを含めます。
[カスタムタスク] フィールドで、利用可能なカスタムタスク関数から選択します。タスクの名前をフィールドに直接入力するか、[参照] をクリックすることもできます。
[タスクの実行] をクリックしてタスクを実行します。カスタムタスクレポートウィンドウに結果が表示されます。
テーブルの [結果] 列を調べて、カスタムタスクがすべてのファイルで適切に実行されたことを確認します。ファイルの詳細な結果情報を表示するには、テーブル内のファイルを選択します。カスタムタスクレポートの下部にある [結果] ペインに詳細が表示されます。

カスタムタスクレポートの保存

カスタムタスクレポートの保存は、カスタムタスクの結果レポートを保存する場合、あるいは結果を他のユーザーと共有する場合に役立ちます。

カスタムタスクレポートを保存するには、カスタムタスクレポートの下部にある [レポートのパブリッシュ] ボタンをクリックします。レポートは HTML ファイルまたは Microsoft^® Word ファイルとして保存できます。MATLAB Report Generator™ がある場合は、レポートを PDF ファイルとして保存することもできます。

レポートファイルを表示し、それをプロジェクトに追加するには、[すべて] のファイルビューに切り替えます。