このセクションでは、 C++test を使って自動生成テストケース、ユーザー定義テストケース、CppUnit テストケースを実行する方法について説明します。

このセクションの内容 :

テストケースの実行

C++test は、あらゆる有効な C++testテストケースおよびレガシーCppUnit テストケースを実行してカバレッジ情報をレポートできます。

GCC -nostdinc オプションの処理

GCC -nostdinc オプションを使用する場合、テスト用実行モジュールを作成するには、次のいずれかのステップを実行する必要があります。

コマンドラインに次のオプションを追加して、データソースおよびストリームのサポート機能を無効にします。 -DCPPTEST_DATA_SOURCES_ENABLED=0 -DCPPTEST_DISABLE_STREAMS_REDIRECTION=1
プロジェクトプロパティのビルド設定でコンパイラオプションを変更して、ヘッダーファイルの標準システムディレクトリをインクルードします。

テストケースを実行するための一般的な手順は次のとおりです。

まだテストケースを生成していない場合、テストケースを生成します。生成方法については「回帰テストと例外検出のためのテストケースの生成」を参照してください。
(オプション) 見つからない関数定義のためのスタブを自動生成する場合は、[ビルトイン] > [Generate Stubs] テストコンフィギュレーションを使用するか、このテストコンフィギュレーションを元にしたユーザー定義テストコンフィギュレーションを使用します。注意 ! これは、定期的に実行されるコマンドラインテストには推奨しません。
- スタブを生成する方法と自動生成スタブをカスタマイズする方法については「スタブの追加と変更」を参照してください。
(オプション) 自動生成スタブとテストがコンパイル可能かどうかをテストの実行前にチェックしたい場合、[ビルトイン] > [Unit Testing] > [Build Test Executable] テストコンフィギュレーション (またはこのテストコンフィギュレーションを元にしたユーザー定義テストコンフィギュレーション) を実行してトライアルビルドを実行します。注意 ! これは、定期的に実行されるコマンドラインテストには推奨しません。
- 「トライアルビルド」を参照してください。
[ビルトイン] > [Unit Testing] > [Run Unit Tests] テストコンフィギュレーション (またはこのテストコンフィギュレーションを元にしたユーザー定義テストコンフィギュレーション) を実行します。
ヒント - [テストケースエクスプローラー] ビューからのテスト実行
[テストケースエクスプローラー] ビューから直接テストを実行することができます (このビューを表示するには、[Parasoft] > [ビューの表示] > [テストケースエクスプローラー] をクリックします)。[テストケースエクスプローラー] ビューで、テストしたいリソース (プロジェクト、フォルダー、テストスイート、テストケース) を選択して右クリックし、ショートカットメニューの [テスト履歴] または [テスト] からテストコンフィギュレーションを実行します。
実行されたテストは、結果ステータスによって色分けされて表示されます。失敗したテストは赤で、成功したテストは緑で表示されます。
テストケースの実行結果をレビューして対処します。
- 「単体テストの結果のレビューと処理」を参照してください。
(オプション) 必要に応じてテスト実行の設定を調整します。
- 「[実行] タブ－テストの実行方法を定義する」を参照。

テンプレート関数のテスト

C++test は、インスタンス化された関数テンプレートとインスタンス化されたクラステンプレートのメンバーに対して静的解析と単体テストを実行できます。

詳細については「C++test でのテンプレート関数のサポート」を参照してください。

cpptestcli によるコマンドラインモードでの回帰テストの実行

定期的にコマンドラインモードで回帰テストを実行するには、単純に [ビルトイン] > [Unit Testing] > [Run Unit Tests] テストコンフィギュレーション (またはこのテストコンフィギュレーションを元にしたユーザー定義テストコンフィギュレーション) を実行するべきです。

たとえば:

cpptestcli -data /path/to/workspace -resource "ProjectToTest" -config team://ExecuteTests -publish

コマンドラインモードテストの詳細については「コマンドラインインターフェイスからのテスト」を参照してください。

トライアルビルド

C++test では、テストを実行せずにテスト用実行モジュールのトライアルビルドを作成できます。トライアルビルドにはテストケースとユーザースタブが含まれます。この機能を利用して、自動生成スタブとテストがコンパイル可能かどうかをチェックできます。トライアルビルドは、テスト対象のプロジェクトにテストケースがまだない場合でも可能です。

トライアルビルドを実行する方法としては、[ビルトイン] > [Unit Testing] > [Build Test Executable] テストコンフィギュレーションを実行することを推奨します。

スタブの自動生成とカスタマイズ

[ビルトイン] > [Generate Stubs] テストコンフィギュレーションの ( またはこのテストコンフィギュレーションをベースにしたユーザー定義テストコンフィギュレーション) を実行すると、見つからない関数定義と変数定義のためのカスタマイズ可能なスタブ (またはスタブテンプレート) が自動的に生成されます。「Executing Test Cases」の説明にもあるように、推奨する方法は、テストケースを実行する前に、まずテストケースを生成し、[Generate Stubs] テストコンフィギュレーションを実行し、 [Build Test Executable] テストコンフィギュレーションを実行することです。

スタブを生成するテストコンフィギュレーションを使ってテストを実行すると、C++test は指定の場所にスタブファイルを作成します。完全なスタブ定義を自動生成できない場合は、スタブテンプレートが作成され、ユーザーは return 文を入力したりインクルードディレクティブを追加したりしてカスタマイズできます。完全なスタブとスタブテンプレートは別々のファイルに保存されます。

自動生成スタブは、他にユーザースタブもオリジナルスタブもない場合にだけ使用されます。

自動生成スタブとスタブテンプレートはカスタマイズできます。詳細については「スタブの追加と変更」を参照してください。スタブまたはスタブテンプレートをカスタマイズした場合は、C++test がスタブ/スタブテンプレートを認識するように解析を再度実行する必要があります。

スタブを生成するユーザー定義テストコンフィギュレーションを作成するには、次の操作を行います。

[Parasoft] メニューの [テストコンフィギュレーション] をクリックします。
[ビルトイン] > [Unit Testing] > [Generate Stubs] テストコンフィギュレーションを右クリックし、ショートカットメニューの [複製] をクリックします。
複製されたテストコンフィギュレーションが「ユーザー定義」カテゴリの下に追加されます。
[ユーザー定義] > [Generate Stubs] テストコンフィギュレーションを選択します。
[実行] タブの [シンボル] タブをクリックします。
(オプション) 生成されたスタブをデフォルトの ${project_loc}/stubs/autogenerated 以外の場所に保存したい場合、[自動生成スタブ出力先] フィールドで出力先を指定します。
[適用] ボタンをクリックしてからテストコンフィギュレーションの設定画面を閉じます。

カスタムテストユニットの定義

デフォルトでは、C++test はテスト対象ファイル (テスト対象のプロジェクトファイル) およびテストスイートのリストを次の方法で算定します。

選択されたテストスイートの中から、テストコンフィギュレーションの [実行] > [全般] タブの [テストスイートファイルの場所のパターン] の条件に一致するテストスイートが実行されます。テストスイートファイルが CPPTEST_CONTEXT あるいは CPPTEST_INCLUDED_TO マクロを使用している場合、適切なソースファイルとヘッダーファイルがテスト対象ファイルになります。
選択されたすべてのプロジェクトソースファイルおよびヘッダーファイルがテスト対象ファイルになります。さらに、C++test は [テストスイートファイルの場所のパターン] の場所を検索し、CPPTEST_CONTEXT マクロがテスト対象ファイルのいずれかに設定されているテストスイートファイルを探します。このテストスイートファイルもテスト対象ファイルになります。

テスト対象ファイルのオリジナル定義を解決するために、他のプロジェクトソースファイルも使用したい場合、テストコンフィギュレーションの [実行] > [シンボル] タブの [他のプロジェクトファイルのシンボルを使用] オプションで設定できます。また、[次の場所で発見されたファイルのシンボルも使用] オプションを使って、使用するスタブを指定できます。[実行] > [全般] タブの [テスト対象コンテキストごとにテスト用実行モジュールを作成する] オプションを使って、コンテキスト ( 1 つのソース/ヘッダーファイルまたはプロジェクト) ごとにテスト用実行モジュールを作成するかどうかを指定できます。

使用するプロジェクトファイルとスタブの指定方法とテスト用実行モジュールの作成方法の詳細については、「[シンボル] タブ」を参照してください。

他から分離した状況での単一ファイルの実行

テストによっては、他の関連するコンポーネントとは分けてコードの単体テストを実行したい場合があります。そのような場合、C++test ではスタブを使ってコードをテストできます。

1 つのファイルを分離してテストするには (異なる「テストベッド」でカスタムスタブと自動生成スタブを使ってテストするには)、次の操作を行います。

テスト対象のファイルを選択します。
[ビルトイン] > [Unit Testing] > [File Scope] > [Run Unit Tests (File Scope)] テストコンフィギュレーションを使ってファイルを実行します。通常、エラーステータスがレポートされて、[コンソール] ビューに詳細が表示されます。その理由は、一部の関数の定義を C++test が発見できないからです。
見つからない関数または変数の定義を用意します。次の操作を行います。
- ユーザー定義スタブを手動で作成します (「スタブの追加と変更」を参照)
- [ビルトイン] > [Unit Testing] > [File Scope] > [Generate Stubs (File Scope)] テストコンフィギュレーションを使ってスタブを自動的に作成し、必要に応じてスタブのソースを変更します ( 「スタブの自動生成とカスタマイズ」および「スタブの追加と変更」を参照)
[ビルトイン] > [Unit Testing] > [File Scope] > [Build Unit Tests (File Scope)] テストコンフィギュレーションを実行してテスト用実行モジュールのトライアルビルドを行います。すべての必要なシンボルを適切に解決するために、そしてカスタムスタブコードによってコンパイルエラーが発生しないようにするために、トライアルビルドの実行を推奨します。
[ビルトイン] > [Unit Testing] > [File Scope] > [Run Unit Tests (File Scope)] テストコンフィギュレーションを使ってテストを実行します。今回はテストが正常に終了するはずです。

ライブラリとオブジェクトファイルを無視する

他と分けた状況で 1 つのファイルをテストする場合、特定のライブラリとオブジェクトをテストから外したいことがあります。テストコンフィギュレーションの [実行] > [シンボル] タブの [オブジェクト/ライブラリファイルを無視する] フィールドで、コマンドラインオプションのパターンを、セミコロン (;) で区切って指定します。リンカーコマンドラインからのオプションだけが無視されます。標準ライブラリ、コンパイラライブラリ、およびプラグマを使ってインクルードされているライブラリは無視されません。

他から分離した状況での関数のテスト

他から分離した状況で関数をテストする方法は色々あります。このセクションでは、セーフティクリティカルなソースコードをテストするためによく使用される方法について説明します。この種のテストのための基本要件は、インストゥルメントモジュールがテスト対象ソースコードを変更してはならないことです。これは、実稼働環境での関数の実行をテスト結果が確実に反映するようにするためです。

テスト対象関数がインストゥルメントされないようにするには、テストコンフィギュレーションでインストゥルメント設定を確認する必要があります。

テストコンフィギュレーションを開き、[実行] > [全般] タブをクリックします。
[単体テスト] 実行モードを有効にし、[実行の詳細] の [インストゥルメントモード] の [編集] ボタンをクリックします。

[テスト対象ソース] カテゴリで、以下の機能だけを有効にします。

private メンバーにアクセス
関数スタブ (スタブインストゥルメントモードの適切な設定と共に)
main() 関数の名前を変更

以下のセクションでは、スタブモードの設定、テストスイート構成ごとのスタブ管理、および他から分離して関数をテストするためのテスト実行ファイルの設定について説明します。

スタブのインストゥルメント設定

テスト対象コードの関数スタブを使用するには、スタブのインストゥルメントを有効にしてスタブモードを選択する必要があります。スタブのインストゥルメントを有効にすると、スタブエンジンがアクティブ化されます。スタブモードを選択することがスタブ呼び出しの適用方法を定義します。スタブモードには以下の 2 種類があります。

関数呼び出しのインストゥルメント
スタブ化された関数のインストゥルメント (関数呼び出しは変更しない)

以下の例で、スタブ関数またはメソッドの呼び出し方法で 2 つのモードがどのように異なるかを示します。

/* Original definition of function to be stubbed */
int Func(void)
{
     // Function body
 }
/* tested function definition */
int testedFunction(void)
{
     int val = Func ();
     /* tested function body */
     return val;
}

サンプルソースコードをそれぞれのスタブモードでインストゥルメントすると、以下の表のようになります。

関数呼び出しのインストゥルメントスタブ化された関数のインストゥルメント

/* Stub function definition */
int CppTest_Stub_StubbedFunc(void)
{ 
       // Stub body 
       return 0 
}
/* Original definition of stubbed function */
int Func(void)  
{
       // Function body 
} 
/* tested function definition */ 
int testedFunction(void)  
{ 
       int val = CppTest_Stub_StubbedFunc();
       /* tested function body */ 
       return val; 
}

/* Stub function definition */
int CppTest_Stub_StubbedFunc(void)
{ 
       // Stub body 
       return 0 
}
/* Original definition of stubbed function */
int Func(void)  
{
       return CppTest_Stub_StubbedFunc();
       // Function body removed 
} 
/* tested function definition */ 
int testedFunction(void)  
{ 
       int val = Func (); 
       /* tested function body */
       return val;  
}

セーフティクリティカルなコードをテストする場合、通常は“スタブ化された関数のインストゥルメントモード”が好まれます。なぜなら、このモードはテスト対象関数の本体を変更しないからです。スタブモードを設定するには、以下の操作を行います。

テストコンフィギュレーションを開き、[実行] > [全般] タブをクリックします。
[インストゥルメントモード] ドロップダウンメニューの隣にある [編集] ボタンをクリックし、スタブモードを有効にします。

この方法でインストゥルメントモードを設定すると、以下の制限事項が発生します。

テスト対象関数が別の関数のスタブを必要とする場合、スタブ化された関数を同じテストセッションでテストすることはできません (テスト対象のソースコードで定義された場合)。
テストスイートは、同じスタブ設定の関数またはメソッドのテストケースをグループ化しなければなりません。
競合するスタブ設定を持つテストスイートを単一のテストバイナリに含めることはできません。この状況が起こるのは、あるテストスイートが、別のテストスイート中にテスト対象関数のスタブがあると推測する場合です。

以下のセクションでは、このような制限事項の対処方法について説明します。

テスト用実行ファイルのビルド設定

テストコンフィギュレーションを開き、[実行] > [全般] タブをクリックします。
[単体テストの設定] セクションで、選択したテストスイートをテスト用実行ファイルに分割するための規則を有効にします。

以下の設定を使用できます。
- 選択対象のテスト実行モジュールを作成: ファイルスコープではないすべてのテストコンフィギュレーションのデフォルト。
- テスト対象コンテキストごとにテスト用実行モジュールを作成する: ファイルスコープのテストコンフィギュレーションのデフォルト。
- テストスイートごとにテスト用実行モジュールを作成する: 選択したテストスイートごとに個別のテストバイナリを作成するには、このオプションを有効にします。テストスイートがテストケースをグループ化する場合、混在できないスタブを明確に選択する必要があるため、このオプションの選択が必要なことがあります。
[適用] ボタンをクリックします。

テストスイート固有のスタブの管理

単体テストの方針として、テストスイートごとに異なるスタブセットを使用しなければならない場合があります。これを実現するために、テストスイートごとに専用のテストコンフィギュレーションを用意するか、テストスイートで直接スタブファイルを指定することができます。後者の方が望ましい方法です。

テストスイートのスタブファイルを指定するには、以下の操作を行います。
テストケースエクスプローラーを開き、テストスイートをダブルクリックします。
[その他のスタブファイル] フィールドに、目的のスタブファイルをドラッグします。
別の方法として、[その他のスタブファイル] フィールドの右側にある [スタブファイルの追加] ボタンをクリックしてスタブファイルを選択することもできます。

直接テストスイートファイルを変更して、GUI を使わずにテストスイート固有のスタブファイルをテストスイートに追加することもできます。テストスイートにスタブファイルを追加するには、テキスト/コードエディターでテストスイートを開き、各スタブファイルに以下のマクロを挿入します。ルートディレクトリパスを使って、特定の場所にあるすべてのスタブを含めることもできます。

CPPTEST_ADDITIONAL_STUB_FILES(<stub file path or root directory>);

このマクロは、有効な C/C++ マクロの場所であればどこにでも指定できますが、 cpptest.h ヘッダーファイルの後に追加しなければなりません。テストスイートレベルで指定したすべてのスタブファイルは、テストコンフィギュレーションの設定に影響を受けるスタブファイルの後に追加されます。

個々のテストケースの実行

テストケースを選択して実行するには、次の操作を行います。

次のいずれかの操作を行って、実行するテスト関数を選択します。

[テストケースエクスプローラー] ビューでテストケースを選択します。
テストケースがあるテストケースエディターを選択し、テストケースエディターにフォーカスがあることを確認します (テストケースエディターの使用の詳細については「回帰テストと例外検出のためのテストケースの生成」を参照してください)。
エディターに表示されたテストスイートファイルでテストケースメソッドを選択します。
プロジェクトツリー
で、実行するテスト関数のノードを選択します。異なるテストスイートからテストケースを選択して実行できます。
たとえば、選択した項目を右クリックして [Parasoft] ショートカットメニューから目的のテストコンフィギュレーションを実行します。

注意 ! CDT 4.x
CDT 4.x を使って作成されたマネージド C/C++ プロジェクトの場合、プロジェクトツリーにテスト関数は表示されません。テストケースを実行するには、コードエディターでテストケース名を選択してください。

テストケースを実行するように設定されたテストコンフィギュレーションを使ってテストを実行します

- (たとえばビルトイン > Unit Testing > Run Unit Tests)。

未解決シンボルのリンカーエラーの解決

テスト対象のコードが参照しているシンボルを C++test が発見できない場合、リンカーエラーが起こることがあります。

リンカーエラーを早期発見するには、次の操作を行います。

テストコンフィギュレーションの [実行] > [シンボル] タブで [未解決シンボルが検出された場合は実行を中断する] チェックボックスをオンにします。 (詳細については「[実行] タブ－テストの実行方法を定義する」を参照してください。)
テストを再度実行します。

未解決のシンボル (未定義の関数) がレポートされます。未解決のシンボルを参照するには、[コンソール] ビューで「次の関数の定義を発見できませんでした」メッセージを探します。

C++test では、コンパイルとリンクの前に未解決のシンボル (未定義の関数) がレポートされます。未解決のシンボルを確認するには、次のいずれかの操作を行います。

[スタブ] ビューで "なし" の定義があるシンボルを探します。
[コンソール] ビューで「Cannot configure stubs for function [function]」メッセージを探します。

未解決のシンボルを解決するには、次の方法があります。

未解決のシンボルのためのスタブを自動生成します。詳細については「スタブの自動生成とカスタマイズ」を参照してください。
プロジェクト中でシンボルが定義されている場合、テストコンフィギュレーションの [実行] > [シンボル] タブで [他のプロジェクトファイルのシンボルを使用] チェックボックスをオンにして1 個のアスタリスク(*) を追加します。シンボル関連の設定の詳細については「[ [実行] タブ－テストの実行方法を定義する」を参照してください。
外部ライブラリにシンボルがある場合、外部ライブラリをリンカーコマンドラインに追加してからテストを再度実行します。
詳細については「プロジェクトの更新」を参照してください。
見つからない関数のためのユーザー定義スタブを作成し、再度テストを実行します。詳細については「スタブの追加と変更」を参照してください。

テスト実行中のデバッガーの使用

詳細については「テスト実行中のデバッガーの使用」を参照してください。

前へ次へ

Page tree

Executing Test Cases

テスト ケースの実行

cpptestcli によるコマンドライン モードでの回帰テストの実行

トライアル ビルド