dotTrace 2020.2ヘルプ

プロファイルユニットテスト

ユニットテストのプロファイリングには3つの方法があります。

  • Visual Studioに統合されたdotTraceの使用。
    これが最も便利な方法です。

  • dotTraceおよびReSharperを使用します(マシンにReSharperがインストールされている場合のみ)。

  • スタンドアロンdotTraceを使用します。*

Visual Studioで統合されたdotTraceを使用して単体テストをプロファイルする

  1. Visual Studioでソリューションを開きます。

  2. ユニットテストでファイルを開きます。

  3. テストクラスまたはテストメソッドを選択します。

  4. 左ガターの対応するサイドバーマークをクリックします。

  5. コンテキストメニューでプロファイルを選択します。

    Profiling Tests with Unit Test Runner png

  6. 単体テストセッションウィンドウが開きます。

  7. プロファイラ設定ウィンドウでプロファイリングオプションを指定します。

  8. テストの実行が完了すると、スナップショットが対応するビューアーで開かれます。

ReSharperから単体テストプロファイリングを起動することもできます。メニューバーのReSharper | ユニット・テスト | プロファイル単体テストまたはReSharper | ユニット・テスト | ソリューションからのすべてのテストのプロファイルを選択します。

ReSharperのUnit Test Sessionsウィンドウから単体テストをプロファイルするには:

  1. 単体テストセッションウィンドウのツリービューでノードを選択します。

  2. ツールバーのプロファイル単体テスト ThemedIcon UtrProfile Screen Gray png をクリックします。

  3. プロファイラ設定ウィンドウでプロファイリングオプションを指定します。

  4. テストの実行が完了すると、スナップショットが表示されます。

スタンドアロンのdotTraceを使用して単体テストをプロファイルする

  1. スタンドアロンアプリケーションとしてdotTraceを実行します。

  2. 新規セッション | ローカルタブを選択します。

  3. プロファイル適用の中央パネルで、スタンドアロンを選択します。

  4. 使用するユニットテストフレームワークに応じて、実行可能ファイルへのパスをアプリケーションフィールドに指定します。以下のフレームワーク/実行ファイルで作業できます:
    • NUnit用のnunit.exe

    • NUnit用のnunit-console.exe

    • MSTest用のMSTest.exe

    • xUnit用のxUnit-console.exe

  5. 単体テストで.dllファイルへのパスを指定し、必要に応じて引数を引数フィールドに追加します。

  6. オプションで、「詳細」オプションを選択して、作業ディレクトリプロファイルの子プロセスなどの追加オプションを構成します。
    例:nunit-console.exeで実行されているNUnitテストをプロファイリングする必要がある場合、NUnitテストランナーはテストを実行するための別のプロセスを作成することに注意してください。nunit-console.exeプロセスをプロファイリングから除外する必要があります。これをする:
    1. 詳細を選択します。

    2. フィルタ処理をクリックします。

    3. 開いたフィルタ処理ウィンドウに、nunit-console* フィルタを追加します。

  7. プロファイラ設定ウィンドウでプロファイリングオプションを指定します。

  8. 実行をクリックします。

テスト・ランナーアプリケーション引数
nUnit用のnunit.exeテストランナー実行可能ファイルへのパス。
例:"C:\ Program Files(x86)\ NUnit 2.5.3 \ bin \net-2.0 \nunit.exe"
単体テストを含むdllファイルへのパス。
例: "C:\ Projects \ ConsoleApplication1 \ ConsoleApplication1Test \ bin \ Debug \ ConsoleApplication1Test.dll"
nUnit用のnunit-console.exeテストランナー実行可能ファイルへのパス。
例:"C:\ Program Files(x86)\ NUnit 2.5.3 \ bin \net-2.0 \nunit-console.exe"
単体テストを含むdllファイルへのパスと、テスト結果が保存されるxmlファイルの名前。
例:"C:¥Test progs¥ConsoleApplication1nUnit¥ConsoleApplication1nUnitTest.dll" /xml:C:\Temp\1.xml
MSTestのMSTest.exeテストランナー実行可能ファイルへのパス。
例:" C:\ Program Files(x86)\ Microsoft Visual Studio 9.0 \ Common7 \ IDE \ MSTest.exe"
引数:
  • /noisolation - MSTest.exeプロセス内でテストを実行します。

  • /testcontainer - 実行したいテストを含むファイルをロードします。

サンプル: /noisolation /testcontainer:"C:\Projects\ConsoleApplication1\ConsoleApplication1Test\bin\Debug\ConsoleApplication1Test.dll"
xUnit用のxUnit-console.exeテストランナー実行可能ファイルへのパス。
例:"C:\ Prog \ xunit-1.5 \ xunit.console.exe"
単体テストを含むdllファイルへのパスと、テスト結果が保存されるxmlファイルの名前。
例: "C:¥Projects¥ConsoleApplication1¥ConsoleApplication1xUnit¥bin¥Debug¥ConsoleApplication1xUnit.dll" / xml 1.xml

生成されるスナップショットには、プロファイリングする単体テストだけでなく、フレームワーク自体をテストするための情報が多数含まれているため、単体テストに関する情報を抽出するのは難しい作業です。スナップショットに単体テストコードがまったく見つからない場合は、テストが実際に実行されていることを確認してください。不十分な権限のためにテストを実行する前に、MSTestが停止することがあります。このような場合は、管理者としてdotTraceを実行してみてください。

最終更新日: 2020年8月05日