既存の自動生成テスト ケースを変更してユーザー定義テスト ケースにすることもできます。
次の操作を行います。
- [テスト ケース エクスプローラー] ビューまたはプロジェクト ツリーで、自動生成テスト スイート ファイルを探します。
- デフォルトでは、自動生成テスト クラスはテスト対象プロジェクト内の tests/autogenerated ディレクトリに保存されます。
- テスト スイート ファイルの保存先を確認または変更するには、テストに使用したテスト コンフィギュレーションを開き、[生成] タブの [テスト スイート] タブの [テスト スイート出力ファイルとレイアウト] フィールドを参照します。詳細については 「生成オプションのカスタマイズ 」 を参照してください。
- 変更する自動生成テスト クラスのノードをダブルクリックします。エディターが開き、テスト クラス ファイルが表示されます。
- 必要に応じてテスト ケースを変更します。次のものを使用します。
- 標準の C/C++ コード マクロ ( 「C++test API ドキュメント」を参照) テスト関数 ( 「利用可能なテスト関数」を参照) 事後条件 (「テスト ケース事後条件マクロ」 を参照)
- コンテンツ アシスタント機能を使用すると、マクロと事後条件を簡単に追加できます。
事後条件テンプレートを追加するには、CPPTEST_POST_CONDITION
と入力し、最後の N の直後にカーソルを置いて Ctrl キーを押しながらスペース キーを押し、事後条件を選択します。
アサーション テンプレートを追加するには、CPPTEST_ASSERT と入力し、最後の T の直後にカーソルを置いて Ctrl キーを押しながらスペース キーを押し、アサーションを選択します。
追加したテンプレートは必ずカスタマイズしてください。
- コンテンツ アシスタント機能を使用すると、マクロと事後条件を簡単に追加できます。
- #include ディレクティブおよびヘッダー ファイルのマクロ定義を使用します。
- #include ディレクティブを使って、テスト用実行モジュールをビルドするときに他のファイルをインクルードします。オリジナルのテスト対象ソース ファイルで見られない型がない限り、インクルード テスト スイート (自動生成テスト スイートで使用されるテスト スイートの種類) は、ヘッダーをインクルードする必要はありません。これは通常、テスト ファクトリをインクルードするためなどの場合に、生成されたテストを変更するときにだけ必要です。
- CPPTEST_CONTEXT マクロを使って、テスト スイートのコンテキストを変更します。このマクロはテスト スイートがテストするファイルを指定します。指定したファイルでテストが実行されるたびに、テスト スイートが実行されます。コンテキストを指定しない場合、テスト スイートはプロジェクトが実行されるたびに実行されます。
- テストの実行前にプロジェクト ツリーでソース ファイルまたはディレクトリを選択した場合、C++test はテスト コンフィギュレーションの [テスト スイート ファイルの場所のパターン] オプションで指定されたすべてのテスト ディレクトリをスキャンします。指定のコンテキストに一致するすべてのテスト スイートが実行されます。
- プロジェクト全体を選択した場合、テスト パス上のすべてのテスト スイートが実行されます。
- 1 つのテスト スイートまたは 1 つのテストを選択した場合、CPPTEST_CONTEXT マクロは、このテスト スイートが関連するソース ファイルをバックトレースするために使用されます。選択したテスト スイートだけが実行されます。
- 変更したファイルを保存します。