C++ のユニットテスト支援

現在のドキュメントでテストを発見する

JetBrains Rider はエディター内で単体テストを検出し、エディター内の各項目の横に対応するアクションインジケータを追加します。

現在のドキュメントでテストを実行またはデバッグする

現在のドキュメントでユニットテストを実行またはデバッグする方法はいくつかあります。アクションインジケータ、メインメニュー、ショートカットを使用することができます:

• テストクラス内の単一のテストまたはすべてのテストを実行またはデバッグするには、その隣のアクションインジケーターをクリックするか、テストにキャレットを置いて Alt+Enter を押します。アクションリストで、テストクラスとして実行 / デバッグを選択します。

• または、ユニットテストの実行 Ctrl+;, R/ ユニットテストのデバッグ Ctrl+;, D コマンドを使用することもできます。これらのコマンドは、メインメニュー（テスト）およびコンテキストメニューでも使用できます。これらのコマンドは、キャレットの位置またはエディターでの選択に応じて動作が異なります。

  • 単一のテストを実行またはデバッグするには、エディター内のテスト名、またはその宣言内の任意の場所にキャレットを置きます。

  • 複数のテストを実行するには、エディターで目的のテストを選択します。

どのような方法でテストを実行またはデバッグしても、実行の進行状況、結果、出力が単体テストウィンドウに表示されます。開いている単体テストセッションがある場合、実行されたテストはそのセッションに追加されます。テストセッションがない場合、または既存のセッションがロックされている場合は、新しいテストセッションが作成されます。

必要に応じて、Ctrl+;, T を押すか、メニューからテスト | 前回の実行を繰り返しを選択することで、最後に実行したテストをいつでも再実行できます。

Ctrl+;, F を押すか、メニューからテスト | 失敗したテストの再実行を選択することで、失敗したテストを再実行することもできます。

ソリューションの単体テストを発見する

単体テスト管理のために、JetBrains Rider はユニットテストウィンドウ ( 表示 | ツールウィンドウ | ユニットテスト ) を提供します。このウィンドウを使用すると、ソリューション全体で単体テストを探索および実行またはデバッグできます。プロジェクトの単体テストは、プロジェクトのビルド後にのみウィンドウに表示されることに注意してください。現在開いているファイルからのテストは自動的に更新され、開いているファイルからの新しいテストは、作成するとすぐに単体テストエクスプローラーに表示されます。

単体テストエクスプローラーでは、次のことができます。

• ソリューション内のテストを探索します。すべての単体テストをツリービューで参照し、テストを検索して部分文字列でフィルタリングし、単体テストをプロジェクト、名前空間などで再グループ化します。

• ビュー内でダブルクリックして、任意のテストのソースコードに移動します。

• 実行またはデバッグテストを選択しました。

• 選択されたテストからの単体テストセッションを作成するおよび / または選択された項目を現在のテストセッションに追加します。

プロジェクトまたはソリューションで単体テストを実行またはデバッグする

単体テストエクスプローラーまたはソリューションエクスプローラーからテストを実行またはデバッグできます。単体テストエクスプローラーを使用すると、テストのみを表示できるという利点がありますが、他のウィンドウを使用する場合は、どのプロジェクト、ファイル、クラスにテストが含まれているかを知る必要があります。

• 単体テストエクスプローラーからテストを実行するには、目的のテストを選択し、ツールバーのユニットテストの実行 Ctrl+;, R/ ユニットテストのデバッグ Ctrl+;, D をクリックします。

  複数のテストを選択するには、グループ化ノードを選択するか、Ctrl キーを押しながら目的の項目をクリックします。あるいは、検索フィールドにクエリ文字列を入力して、実行前に一致しないテストをすべて除外します。この場合、残りの一致するテストのみが実行されます。

• ソリューション内のすべてのテストを実行またはデバッグするには、メインメニューでテスト | ソリューションからすべてのテストを実行を選択するか、Ctrl+;, L を押します。

どのような方法でテストを実行またはデバッグしても、実行の進行状況、結果、出力が単体テストウィンドウに表示されます。開いている単体テストセッションがある場合、実行されたテストはそのセッションに追加されます。テストセッションがない場合、または既存のセッションがロックされている場合は、新しいテストセッションが作成されます。

必要に応じて、Ctrl+;, T を押すか、メニューからテスト | 前回の実行を繰り返しを選択することで、最後に実行したテストをいつでも再実行できます。

Ctrl+;, F を押すか、メニューからテスト | 失敗したテストの再実行を選択することで、失敗したテストを再実行することもできます。

ユニットテストセッション

アプリケーションの特定の部分を対象とする単体テストを複数の単体テストセッションにグループ化できます。単体テストセッションには、さまざまなプロジェクトのテストを含めることができます。複数のテストセッションを作成し、必要に応じて個別に実行できます。1 つのテストを複数の異なるテストセッションに含めることができます。

単体テストセッションの詳細については、「ユニットテストセッション」を参照してください。

実行プロセス

JetBrains Rider には、単体テストを実行する方法がいくつか用意されています。どちらの方法を選択しても、実行の進行状況、テスト結果、出力が単体テストウィンドウに表示されます。

テストは単体テストセッションで実行されているため、現在実行中のテストの横に進行状況アイコンが表示されます。複数の単体テストセッションを同時に実行できます。ただし、テストをデバッグする場合、一度に実行できるテストセッションは 1 つだけです。

単体テストを実行またはデバッグする場合、JetBrains Rider はプロジェクトのプロパティで指定されたコマンドおよび作業ディレクトリ構成パラメーターを使用します。これらのプロパティにアクセスするには、ソリューションエクスプローラーでプロジェクトを右クリックし、Properties | 【ビルド構成】 | ローカルデバッガーを選択します。

実行結果と出力を分析する

実行が終了すると、結果はユニットテストウィンドウに表示されます。

出力ペイン（ツールバーの出力位置を切り替える ボタンを使用して右側または下部に配置できます）には、選択したテストの出力が表示されます。

デフォルトでは、JetBrains Rider は、出力領域の現在の幅に従って、出力の長い行を折り返します。必要に応じて、JetBrains Rider 設定 Ctrl+Alt+S のビルド、実行、デプロイ | ユニットテストページのユニットテストセッションの出力で長い行を折り返すチェックボックスをオフにして、長い行を折り返さないことを選択します。

テストのグループ化を変更するには、ツールバーのグループ化 セレクタを使用します。セレクタの上部にある、テスト階層、プロジェクト構造などの事前に定義されたグループ化モードのいずれかを選択するか、セレクタの下部にある、グループ化プロパティのカスタムセットを選択するために使用します。

ステータスバーには、セッション内のテストの合計数と、さまざまな状態のテスト数が表示されます。

デフォルトでは、すべての状態のテストが表示されますが、対応するアイコンをクリックして、状態によってテストをフィルタリングできます。

Unit Test Sessions ウィンドウの各テストのステータスは、次のアイコンのいずれかで表示されます。

グループ化項目のステータスを表示するために同じアイコンが使用されます

アイコンは各セッションのタブでも使用され、セッションの全体的な実行結果を表示します。

テストセッションツリーの上にある対応するアイコンは、各状態にあるテストの数を示しています。 アイコンは、セッション内のテストの総数を示します。

これらのアイコンを使用して、対応するステータスのテストのみが表示されるようにツリーをフィルタリングできます。

ユニットテストウィンドウにフォーカスしているときは、単体テストアクション用の簡単なショートカットを使用できます。例: 選択したテストのデバッグに Ctrl+;, D の代わりに Ctrl+D を使用できます。ユニットテストウィンドウで機能する追加のショートカットの完全なリストは次のとおりです。

• Shift+Enter — 選択したテストを実行する

• Ctrl+D — 選択したテストのデバッグ

• Ctrl+Y — 現在のセッションを実行

• Alt+Shift+Insert — 新規セッションの作成

• Ctrl+Alt+Insert — 選択したテストをセッションに追加する

• Delete — 選択したテストを削除する

• Ctrl+L — ソリューションからすべてのテストを実行