C++test では、デバッガーを使ってテストケースをステップ実行し、コードの内部の状態を詳しく検証できます。たとえば、どのように C++test が予想外の出力を取得したのか、なぜテストケースが失敗したのかを詳しく知りたい場合などにテストケースをデバッグします。このとき、ユーザーが自分でコードにブレークポイントをセットする必要はありません。ユーザーが選択したテストケース関数の先頭に C++test が自動的にブレークポイントをセットします。テストのデバッグは、コンパイラのデバッガーを使って実行することも、Eclipse IDE から直接デバッグすることも可能です。このセクションの内容 :

テストケースデバッグのサポート

C++test は、次のデバッガーを使って 2 種類のモードでテストケースのデバッグをサポートします。

Eclipse または Visual Studio の内部デバッガー
外部のデバッガー

開発環境によって、どのモードのテストケースデバッグを選択するべきかが決まります。Visual Studio IDE を使用する場合、Visual Studio の内部デバッガーを選択できるはずです (詳細については、C++test Visual Studio 版のドキュメントを参照してください)。開発環境が Eclipse IDE での直接デバッグをサポートする場合、テストコンフィギュレーションで Eclipse の内部デバッガーを選択できるはずです。開発環境が Eclipse 内でのデバッグをサポートしていない場合も、テストケースのデバッグ用の外部デバッガーを構成できます。

ネイティブ開発の場合、C++test は次のデバッガーをサポートします。

GNU GCC コンパイラと gdb デバッガーおよび ddd デバッガーフロントエンド
Sun CC コンパイラと gdx デバッガー
コマンドラインインターフェイスから起動および構成できる他のデバッガー (「デバッガーの設定」を参照)
Eclipse の内部デバッガー (CDT)
Visual Studio の内部デバッガー

組込み開発の場合、C++test は次のデバッガーをサポートします。

Texas Instruments Code Composer Studio (バージョン 5.x)
QNX Momentics IDE (SDP 6.4 & 6.5)
MDK-ARM (バージョン 4.12 以降)
Lauterbach Trace32 デバッガー (リリース Feb/2013 以降)
Spansion SOFTUNE (FR) Development Tools for Eclipse (V01L02)

デバッガーの設定

C++test は、2 種類のモードでのテストケースデバッグに対応して設定できます。

IDE (Eclipse/VisualStudio) での内部的なデバッグ
外部デバッガーによるデバッグ

Eclipse IDE でのデバッグを有効にするには、次の操作を行います。

テストケースの実行に使用するテストコンフィギュレーションを開きます。
[実行] > [実行時] タブをクリックします。
[テストケースのデバッグオプション] の [デバッガーでテストを実行する(*)] チェックボックスをオンにします。
[Eclipse の内部的なデバッガーとデバッグ構成を使用する] を選択し、ドロップダウンメニューからEclipse デバッグ構成を選択していることを確認します。

IDE の内部デバッガーモードの場合、C++test は選択された Eclipse デバッグ構成を使って、テスト用実行モジュールの実行と IDE でのデバッグモードへの切り替えを自動化します。詳細については「内部デバッガーモードでのデバッグ」を参照してください。

外部デバッガーを使ったデバッグを有効にするには、次の操作を行います。

テストケースの実行に使用するテストコンフィギュレーションを開きます。
[実行] > [実行時] タブをクリックします。
[テストケースのデバッグオプション] の [デバッガーでテストを実行する(*)] チェックボックスをオンにします。
[外部のデバッガーを使用] を選択します。

外部デバッガーモードの場合、開発環境によっては、さらに設定が必要なことがあります。詳細については「外部デバッガーを使ったデバッグ」を参照してください。

内部デバッガーモードでのデバッグ

Eclipse デバッグ構成の準備

既存の Eclipse デバッグ構成を使ってテストケースをデバッグできます。動作する Eclipse デバッグ構成がない場合、まずデバッグ構成を用意する必要があります。Eclipse デバッグ構成の設定の詳細については、使用している開発環境のドキュメントを参照してください。

C++test のテストコンフィギュレーションで指定する前に、Eclipse デバッグ構成を使ってオリジナルプロジェクトコードをデバッグできるかどうか検証することを推奨します。

Standard Create Process ランチャーの使用(standard CDT/Native development)

デバッグ構成の場合、デバッガーを選択することができるので、Standard Create Process ランチャーの使用を推奨します。デフォルトの Eclipse ランチャー (GDB DSF) の Create Process ランチャーではデバッガーを選択できません。Standard Create Process ランチャーを選択するには、[ウィンドウ] メニューの [設定] をクリックし、[設定] ダイアログで [実行/デバッグ] > [起動中] > [デフォルトランチャー] をクリックします。

選択した Eclipse デバッグ構成の使用

テストケースの実行に使用するテストコンフィギュレーションを開きます。
[実行] > [実行時] タブをクリックします。
[Eclipse の内部的なデバッガーとデバッグ構成を使用する] を選択していて、ドロップダウンメニューから Eclipse デバッグ構成を選択していることを確認します。既存の Eclipse デバッグ構成の名前をリロードするために [リフレッシュ] をクリックする必要がある場合があります。

外部デバッガーを使ったデバッグ

ネイティブ開発でのテストケースのデバッグ

GCC コンパイラのデフォルトデバッガーは gdb です。
Sun CC コンパイラのデフォルトデバッガーは dbx です。
xxgdb および ddd デバッガーもサポートされます。

C++test は以下のコマンドラインを使ってデフォルトデバッガーを起動します。

GNU GCC/Windows: cmd.exe /C gdb -x %s
GNU GCC/Linux: LC_ALL=C /usr/X11R6/bin/xterm -e gdb -x %s &

デバッガーまたはデバッガーコマンドラインの変更

プロジェクトのプロジェクトツリーノードを右クリックし、ショートカットメニューの [プロパティ] をクリックします。[プロパティ] ダイアログが開きます。
[Parasoft] > [C++test] > [その他] を選択します。
[詳細] オプションの表で [追加] をクリックし、新しいエントリを追加します。
次の書式を使って [オプション] にコマンドラインを追加します。
testrunner.debuggerCommandLine <COMMAND_LINE>.

例:

xxgdb デバッガーを使用するために、次のコマンドを使用します。 testrunner.debuggerCommandLine /usr/X11R6/bin/xterm -e xxgdb -x %s &
ddd デバッガーを使用するために、次のコマンドを使用します。 testrunner.debuggerCommandLine ddd -x %s &

組込み開発のためのテストケースのデバッグ

C++test は、開発環境の特定の機能に基づいて、組込み開発環境でのテストデバッグをサポートします。詳細については「テストケースのデバッグ」を参照してください。

デバッガーを使ったテスト実行

このセクションでは、ネイティブ開発環境でテストをデバッグする方法について説明します。組込み環境でテストをデバッグする方法については「テストケースのデバッグ」を参照してください。

使用しているコンパイラのデバッガーを使ってテストを実行するには、次の操作を行います。

Debug Unit Tests テストコンフィギュレーションを準備します。
- ビルトインテストコンフィギュレーションの Debug Unit Tests を使用するか、Debug Unit Tests ビルトインテストコンフィギュレーションを複製してカスタムテストコンフィギュレーションを作成します。(カスタムテストコンフィギュレーションの作成については、『Parasoft Test ユーザーズガイド』の「Parasoft Test の設定」>「テストコンフィギュレーションとルールの設定」を参照)。
次の操作を行って、ビルトインまたはカスタムの Debug Unit Tests テストコンフィギュレーションを実行します。
1. 以下のいずれかの方法で、デバッグするテストケースを選択します。
  - テストケースエクスプローラーでテストケースを選択します。
  - コードエディターでテストケースの関数名を選択します。
  - プロジェクトエクスプローラーでテストケース関数を選択します (CDT 4.x+ Managed C/C++ プロジェクトの場合、この操作はできません) 。
2. ビルトインまたはカスタムの Debug Unit Tests テストコンフィギュレーションを実行します。たとえば、テスト対象を右クリックし、ショートカットメニューショートカットメニューの [Parasoft] からテストコンフィギュレーションを選択して実行します。適切なデバッガーが起動し、選択した各テストケース関数の先頭でブレークポイントが自動的に設定されます。
  Microsoft Visual Studio でのデバッグ デバッガー環境として Microsoft Visual Studio 6 を使用する場合、Visual Studio GUI を開いた後に次の操作を行います。
  - [プロセスにアタッチ] ダイアログでテストプロセスを選択し、[OK] をクリックします。
  - [実行の中断] をクリックします (または [デバッグ] メニューの [中断] をクリックします。
  - F5 (Go) キーを押します。テストケース関数の先頭でデバッガーがブレークします。
  Microsoft Visual Studio 2003 サービスパック 1 をデバッガー環境として使用する場合、Visual Studio GUI を開いた後に次の操作を行います。
  - [プロセス] ダイアログでテストプロセスを選択し、[アタッチ] をクリックします。
  - [プロセスにアタッチ] ダイアログで [OK] をクリックしてアプリケーションタイプ (ネイティブ) を確認します。
  - [プロセス] ダイアログを閉じます。
  他のバージョンの Microsoft Visual Studio の場合、余分な操作は必要ありません。
標準のデバッガー機能を使ってテストケースをステップ実行します。

C++test でデバッガーを使用する前に、デバッガーの実行モジュールが $PATH 環境変数に含まれていることを確認してください。
デバッガーが起動されるのは、1 個以上のテストケースを選択してデバッグ用テストコンフィギュレーションを実行した場合だけです。そうでない場合、以下の警告がコンソール出力に表示され、デバッグなしで実行が続きます。
Warning: debugger will not be activated - no valid breakpoints found. Select (test case) function definitions to set breakpoints.

デバッグ構成の場合、デバッガーを選択することができるので、Standard Create Process ランチャーの使用を推奨します。この設定を行うには、[ウィンドウ] メニューの [設定] をクリックし、[設定] ダイアログで [実行/デバッグ] > [起動中] > [デフォルトランチャー] をクリックします。デフォルトの Eclipse ランチャー (GDB DSF) の Create Process ランチャーでは、デバッガーを選択することはできません。

テスト ケース デバッグのサポート