このセクションでは、プロジェクト レベルおよびファイル レベルのオプション設定をカスタマイズする方法について説明します。
このセクションの内容
オプション設定の参照と変更
C/C++test でコードを適切にテストするには、ビルド設定を正しく指定する必要があります。テスト環境に合わせて詳細設定 (インストゥルメントのオプション) も変更できます。
オプション設定を参照し変更するには、次の操作を行います。
C/C++ プロジェクト ツリー (「プロジェクト ツリー」と呼ばれます) でオプション設定を変更するプロジェクトまたはファイルのノードを右クリックし、ショート カット メニューの[プロパティー] をクリックします。[プロパティー] ダイアログが表示されます。
- 左側のペインの [Parasoft] > [C/C++test]カテゴリを展開します。
- オプション設定を変更するカテゴリを選択します。各カテゴリで設定できるオプションにつ いては下記で説明します。必ず確認して必要に応じて変更しなければならないのは「ビルド設定」です。オプションとして他の設定を確認します。
- 右側のペインのオプションを変更します。
- [適用] をクリックして [OK] をクリックします。
設定の一覧
ビルド設定
オプションのソース: オプションの設定方法を指定します。 すべてのオプションを手動で指定するこ とも、ビルド システムのオプション、ビルド データ ファイルのオプション、Green Hills プロジェクトのオプション、Eclipseマネージド Make プロジェクト設定をベースにすることもできます。
ビルド データ ファイルのオプションを使用 既存のビルド システムを使った C++test プロジェクトで説明されているとおり、cpptestscan ユーティリティを使ってビルド データ ファイルを作成済みの場合でビルド データ ファイルの再生成と更新を手動で管理したい場合、このオプションを推奨します。
- ビルド システムのオプションを使用 「コマンドラインからプロジェクトをビルドできるが、ビルド データ ファイルを作成していない場合」または「ビルド データ ファイルの再生成と更新を C/C++test に任せたい場合」、このオプションを推奨します。
Green Hills Software (GHS) プロジェクトのオプションを使用 Green Hills IDE で開発したプロジェクトの場合、このオプションを推奨します。
マネージド Make C/C++ プロジェクトのオプションを使用 Eclipse で開発した「マネージド Make プロジェクト」の場合、このオプションを推奨します。
すべてのオプションを手動で指定 上記以外のプロジェクトの場合、このオプションを推奨します。
[オプション ソース] で選択した項目によって、表示されるオプションは異なります。
注意
ビルド データ ファイルを手動で管理する方法を選択した場合、ビルド データ ファイルを作成するためのメカニズムをビルド プロセスに統合することを強く推奨します。そうすれば、開発チームのメンバーがこのビルド データ ファイルを使用できるだけでなく、通常のビルド作業の最中にビルド データ ファイルをシームレスに生成または更新するのに役立ちます。
複数の C/C++test プロジェクト構成の管理
複数の C/C++test プロジェクト構成を使って、さまざまな構成のテストを管理することができます。たとえば、ホスト コンパイラ、クロス コンパイラ、デバッグ モードでのテスト、リリース モードでのテストなどに対してプロジェクトを構成できます。
また、現在のアクティブなプロパティをファイルにエクスポートしたり、以前に保存したプロパティをファイルからインポートすることもできます。
- プロジェクト エクスプローラーでプロジェクトを右クリックし、[プロパティ] をクリックします。
- [Parasoft] > [C/C++test] を選択して [エクスポート] または [インポート] をクリックします。
- プロパティを参照して [保存] または [開く] をクリックします。
プロパティをエクスポートすると、cpptestcli -settings
パラメーターで引数として使用できるファイルが作成されます。このファイルを利用して、コマンドラインからテストするときに別のプロジェクト構成に簡単に切り替えることができます。
ビルド データ ファイルのオプションを使用
次のオプションを設定します。
- ビルド データ ファイル 作成したビルド データ ファイルの場所を入力します (ビルド データ ファイルの作成については「cpptestscan または cpptesttrace を使ってビルド データ ファイルを作成する」を参照)。
- 絶対パスを使用すると、互換性のないプロジェクトになることがあります。次の C/C++test 変数を使ってパスを指定することを推奨します。
${resource_loc}
は、特定のプロジェクト リソースへの絶対パスです。たとえば、${resource_loc:/MyProject/linked_src_dir/source.cpp}
はC:\src\source.cpp
に解決されます。
- 絶対パスを使用すると、互換性のないプロジェクトになることがあります。次の C/C++test 変数を使ってパスを指定することを推奨します。
- 毎回 C/C++test がオプションをスキャンするときに、前回のオプションを消去したい場合、[前回収集されたオプションを保持 (インクリメンタル ビルド)] チェックボックスをオフにします。オンにした場合は、各ビルドがインクリメンタル ビルドとして処理されます。
- インクリメンタル ビルドがある場合、ビルド データ ファイルからのオプションのスキャンが終了した後にビルド データ ファイルを削除するには、[処理終了後にビルド データ ファイルを削除] チェックボックスをオンにします。このオプションは、ビルドが実行されるたびにビルド データ ファイルが際限なく拡大するのを防止します。
- [コンパイラ設定] で、C および C++ ソースのためのコンパイラの実行モジュール、リンカー、コンパイラファミリーを選択します。使用しているコンパイラがリスト中にない場合、カスタム コンパイラ定義を追加します (詳細については「カスタム コンパイラを使用するテストの設定 」を参照)。
- [オプション] で、Makefile でまだ指定していない、テスト固有または C/C++test 固有のコンパイラオプションとリンカーオプションを指定します。詳細については「コンパイラとリンカーのオプション設定」を参照してください。
指定のビルド データ ファイル中でオプションが変更されると、C/C++test は自動的にオプションを再スキャンしてプロジェクトを適切に変更します。たとえば外部コンフィギュレーション ファイルが変わったなどの理由でオプションを強制的にすぐに更新したい場合は、[キャッシュをリセット] ボタンをクリックします。
ビルド システムのオプションを使用
次のオプションを設定します。
- [ビルド コマンドライン] フィールドでオプションを確認します。C/C++test は、このオプションを利用して、ビルドの実行 (たとえば makefile による make の実行) およびプロセ スからのプロジェクト ビルド オプションの収集を行います。
- C/C++test は、[ビルド コマンドライン] の指定に従って、適切な値を再割り当てしてコンパイラを置き換えます。
- C/C++test オプション スキャナーは
${CPPTEST_SCAN}
変数で表されます。
- C/C++test のデフォルトとは異なるコンパイラ/リンカー変数を使用している場合、必要に応じてビルド コマンドラインを変更します。
- C/C++test は、処理されるすべてのファイルのオプションを、オプション スキャナーを使ってスキャンします。すべてのソース ファイルについてコンパイルを強制的に実行するように適切なコマンドラインを指定する必要があります。そうしないと、 一部のファイルがテストされません。
次は GNU のビルド コマンドラインの例です。
make -i -B objects CXX=${CPPTEST_SCAN} CC=${CPPTEST_SCAN}
このコマンドラインは、-B
フラグ (すべてのターゲットを無条件に make するフラ グ) および-i
(エラーを無視するフラグ) を使って make ターゲットobjects
を make します。make 変数CXX
およびCC
は${CPPTEST_SCAN}
で代替されます。このコマンドラインを使用すると、objects
ターゲットをビルドするために通常コ ンパイルされるすべてのソース ファイルからオプションを抽出できます。- コマンドライン シェルが bash などの特別な方法で $ 記号を処理する場合、バック スラッシュ (\) を使って $ 記号を必ずエスケープしてください。たとえば:
CXX=\${CPPTEST_SCAN}
- C/C++test は、適切な値を再割り当てしてコンパイラとリンカーを置き換えることが できる限り、任意のビルド プロセス (nmake、ant、または任意のビルド スクリ プト) をサポートします。適切なオプションについてはビルド エンジニアに相談してください。
重要な注意 -B スイッチについて
ビルド コマンドラインは、 -B スイッチ オプション (無条件にすべてのターゲットを make するオプション) を含むように設定済みです。このオプションをサポートするのは GNU Make 3.80+ だけです。
以前の make を使用している場合、プロジェクトを作成する前にビルドをクリーンしてください。-k スイッチを保持してください。
-B スイッチ オプションをサポートしない make を使用している場合、さらにコマンドラインを 変更する必要があります。プロジェクト プロパティで使用されるデフォルトのビルド コマンドラ インにはターゲットがありません。解析対象コードをビルドするために使用するターゲットの指 定を推奨します。 例:
make -i CXX=\${CPPTEST_SCAN} ... all
(all
はターゲット)
また、通常のビルド ターゲットの前に clean ステップを追加します。 例:
make -i CXX={CPPTEST_SCAN} ... clean all
このコマンドは、まず clean ターゲットを make し、それから all
ターゲットを make します。C/C++test からの make 実行は実際にオブジェクト ファイルをビルドすることはありませんが、 clean
ステップは実際にオブジェクト ファイルを消去します。
3.[ビルド作業ディレクトリ] フィールドで、ビルド プロセスを実行するディレクトリを指定します。
- 絶対パスを使用すると、互換性のないプロジェクトになることがあります。次の C/C++test 変数を使ってパスを指定することを推奨します。
${project_loc}
は Eclipse プロジェクトの場所 (.project
ファイルがある場所) への絶対パスです。リンクされたソース フォルダー (実際にはプロジェクトの場所に存在しないソース ファイル) がプロジェクト中にある場合、この変数を使用しないでください。詳細については、下の囲みを参照してください。${resource_loc}
は、特定のプロジェクト リソースへの絶対パスです。たとえば、${resource_loc:/MyProject/linked_src_dir/source.cpp}
はC:\src\source.cpp
に解決されます。
- 絶対パスを使用すると、互換性のないプロジェクトになることがあります。次の C/C++test 変数を使ってパスを指定することを推奨します。
4.[従属ファイル] フィールドで、変更をチェックする Makefile を指定します。指定したファイルが変更された場合、オプションは自動的に更新されます。
絶対パスを使用すると、互換性のないプロジェクトになることがあります。次の C/C++test 変数を使ってパスを指定することを推奨します。
${project_loc}
は Eclipseプロジェクトの場所 (.project
ファイルがある場所) への絶対パスです。リンクされたソース フォルダー (実際にはプロジェクトの場所に存在しないソース ファイル) がプロジェクト中にある場合、この変数を使用しないでください。詳細については、下の囲みを参照してください。${resource_loc}
は、特定のプロジェクト リソースへの絶対パスです。たとえば、${resource_loc:/MyProject/linked_src_dir/source.cpp}
はC:\src\source.cpp
に解決されます。
5.[コンパイラ設定] で、C および C++ ソースのためのコンパイラの実行モジュール、リンカー、コンパイラファミリーを選択します。使用しているコンパイラがリスト中にない場合、カスタム コンパイラ定義を追加します (詳細については「カスタム コンパイラを使用するテストの設定 」を参照)。
6.[オプション] で、Makefile でまだ指定していない、テスト固有または C/C++test 固有のコンパイラオプションとリンカーオプションを指定します。詳細については「コンパイラとリンカーのオプション設定」を参照してください。
[従属ファイル] フィールドで指定したファイルが変更されると、C/C++test は自動的にオプションを再スキャンしてプロジェクトを適切に変更します。 たとえば外部コンフィギュレーション ファイルが変わったなどの理由でオプションを強制的にすぐに更新したい場合は、[キャッシュをリセット] ボタンをクリックします。
Green Hills Software (GHS) プロジェクトのオプションを使用
次のオプションを設定します。
- [ルート プロジェクト ファイル (gpj)] フィールドで、オプションのスキャンを開始する Green Hills (
*.gpj
) プロジェクト ファイルの場所を入力します。- 絶対パスを使用すると、互換性のないプロジェクトになることがあります。次の C/C++test 変数を使ってパスを指定することを推奨します。
${project_loc}
は、Eclipse プロジェクトがある場所 (.project
ファイル がある場所 ) への絶対パスです。リンクされたソース フォルダー (プロジェクトとは異なる場所にあるソース ファイル) がプロジェクトにある場合、この変数を使ってはいけません。${resource_loc}
は、特定のプロジェクト リソースへの絶対パスです。たとえば、${resource_loc:/MyProject/linked_src_dir/source.cpp}
はC:\src\source.cpp
に解決されます。
- 絶対パスを使用すると、互換性のないプロジェクトになることがあります。次の C/C++test 変数を使ってパスを指定することを推奨します。
- [サブプロジェクト] フィールドでプロジェクトを選択し、[リフレッシュ] ボタンをクリッ クします。
- GPJ プロジェクト階層の中にある、利用可能な "テスト可能" プロジェクトを選択できます (これはルート自体であることもあります)。または、互換モードを使用するために (たとえテスト可能でない場合でも) ルート ノードを選択できます。この機能は、"テスト可能ではない" プロジェクトの静的解析をサポートするためのものです。
- "テスト可能" プロジェクトと "テスト可能ではない" プロジェクトの違い、および 互換モードの詳細については、 「C++test はどのように GHS オプション ソースを使用するのか」を参照してください。
- [コンパイラ設定] で、C および C++ ソースのためのコンパイラの実行モジュール、リンカー、コンパイラファミリーを選択します。
- [オプション] で、プロジェクトでまだ指定していない、テスト固有または C/C++test 固有のコンパイラオプションとリンカーオプションを指定します。
- 詳細については「コンパイラとリンカーのオプション設定」を参照してください。
GHS プロジェクト ファイルのオプションが変わると、C++test は自動的にオプションを再スキャンし、オプションに従ってプロジェクトを変更します。たとえば外部コンフィギュレーション ファイルが変わったなどの理由でオプションを強制的にすぐに更新したい場合は、[キャッシュをリセット] ボタンをクリックします。
C/C++test はどのように GHS オプション ソースを使用するのか
C/C++test は次の種類の GPJ プロジェクトをサポートします。つまり C/C++test は、これらのプロ ジェクト タイプで指定されたプロジェクト ノードを、ソース オプションとビルド オプションをスキャンするプロジェクトとして扱います。
- プロジェクト
- サブプロジェクト
- プログラム
- ライブラリ
- DLL
- Select One
- 共有プロジェクト
- シングルトン ライブラリ
- INTEGRITY アプリケーション
C/C++test は GPJ プロジェクトを 2 つのグループに分けています。
- テスト可能なプロジェクト: プログラム、ライブラリ、および DLL が該当します。 これらのプロジェクト タイプの成果物は、よく知られたもの (実行可能ファイルとライブラリ) であり、C/C++test はこれらのプロジェクト タイプに基づいてテスト用実行モジュールをビルドできます。GHS プロジェクトのインポート用ウィザードを使ってインポートできるプロジェクトは、これらのプロジェクト タイプだけです。
- テスト可能ではないプロジェクト: その他のすべてのプロジェクト タイプは、そのすべてのソースとサブプロジェクトのビルド オプションを取得するために使用できます。
ルート プロジェクトとは、オプションのスキャンの開始地点として選択された最上位レベルのプロジェクト ファイルのことです。
複雑な構造を持つプロジェクトの場合:
- ルートから開始する論理プロジェクトの階層における第 1 レベルのすべての "テスト可能ではない" プロジェクトは、ワークスペースの一種として扱われ、オプションが取得されます。
- テスト可能プロジェクトのサブプロジェクトは、テスト可能な親の直接の子と見なされます。 サブプロジェクトのオプションが読み込まれます。
テスト可能なソースは C 言語および C++ 言語のソースです。
GPJ プロジェクトから取得されるビルド オプションには次の 2 種類があります。
- コンパイル オプションとリンク オプション
- コンパイラ ツールに直接渡されないが、MULTI Builder 自体によって特別な方法で解釈されるビルド プロパティ (MULTI Builder のみのオプション)
C/C++test では、特定のソース ファイルのビルド オプション (コンパイル オプションとビルド プロ パティ) には、ソース ノード自体のすべてのオプションに加えて、このソース ファイルにつながるすべての親プロジェクト ノードから取得されたすべてのオプションが含まれます。さらに、特定のテスト可能プロジェクトのリンク オプションには、テスト可能プロジェクト ノード自体のすべてのオプションに加えて、このプロジェクトにつながるすべての親プロジェクト ノードから取得されたすべてのオプションが含まれます。
認識されるビルド プロパティは次のとおりです。これらのビルド プロパティは MULTI Build Options Editor から指定されている可能性があります。
- このファイルに相対のソース ディレクトリ (:sourceDir)
- 最上位レベルのプロジェクトに相対のソース ディレクトリ (:sourceDirNonRelative)
以前C/のバージョンの C/C++test で利用できた GHS の下位互換性のために、現行バージョンの C/C++test には互換モードが用意されています。互換モードでは、ルート プロジェクトがそのプロジェクト タイプに関わらず (そのプロジェクト タイプがサポートされている限り)、常にテスト可能として扱われます。ただし、"テスト可能ではない" プロジェクトから実行用モジュールをビルドすることは不可能な場合があります。よくある原因は次の 2 つです。
- スキャンされたリンク オプションが有効でないか、十分ではない。
- 元のソースが正しいアプリケーションに構成されない (たとえば、重複するグローバル シン ボル名がソース中にある場合など)。ほとんどの場合この状況は、複数のプログラム ノードあるいはライブラリ ノードを持つコンテナー的なプロジェクトで発生します。
互換モードは主に、完全なプロジェクトの構成で発見されるすべてのテスト可能ソースに対する静的解析で使用されます。
マネージド Make C/C++ プロジェクトのオプションを使用
次のオプションを設定します。
- [コンフィギュレーション] フィールドで、使用するコンフィギュレーションを選択します。利用可能なコンフィギュレーションのリストを更新するには [更新] をクリックします。
- [種類] フィールドで、コンパイラが属するコンパイラの種類を選択します。
- [カスタム コマンドを使用] エリアで、C コンパイラ、C++ コンパイラ、およびリンカー に使用するカスタム コマンドを指定します。
- [オプション] エリアで、プロジェクトで (Make ファイル ターゲットとして) 指定していないテスト固有または C/C++test 固有のコンパイラ/ リンカー オプションを指定します。詳細については「コンパイラとリンカーのオプション設定」を参照してください。
すべてのオプションを手動で指定
次のオプションを設定します。
- [コンパイラ オプション] フィールドで、使用するコンパイラ オプション入力します。
- [作業ディレクトリ] フィールドで、コンパイラが実行するディレクトリを入力します。
- 絶対パスを使用すると、互換性のないプロジェクトになることがあります。次の C/C++test 変数を使ってパスを指定することを推奨します。
${project_loc}
は、Eclipse プロジェクトがある場所 (.project
ファイル がある場所 ) への絶対パスです。リンクされたソース フォルダー (プロジェクトとは異なる場所にあるソース ファイル) がプロジェクトにある場合、この変数を使ってはいけません。${resource_loc}
は、特定のプロジェクト リソースへの絶対パスです。たとえば、${resource_loc:/MyProject/linked_src_dir/source.cpp}
はC:\src\source.cpp
に解決されます。
- 絶対パスを使用すると、互換性のないプロジェクトになることがあります。次の C/C++test 変数を使ってパスを指定することを推奨します。
- [リンカー オプション] フィールドで、使用するリンカー オプションを入力します。使用しているコンパイラがリスト中にない場合、カスタム コンパイラ定義を追加します (詳細については「カスタム コンパイラを使用するテストの設定 」を参照)。
- [コンパイラ設定] で、C および C++ ソースのためのコンパイラの実行モジュール、リンカー、コンパイラファミリーを選択します。コンパイラとリンカーの設定は一致していなければなりま せん。使用しているコンパイラがリスト中にない場合、カスタム コンパイラ定義を追加します (詳細については「カスタム コンパイラを使用するテストの設定 」を参照)。
実行の設定 (ファイル レベルのみ)
テスト ケースの実行中に、選択したソース ファイルをインストゥルメントするかどうかを指定します。
複数のファイルにこの設定を適用するには、プロジェクトの中からファイルを選択して右クリックし、[Parasoft] > [C/C++test] > [実行の設定] を選択します。選択したすべてのファイルに現在の設定が適用される点に注意してください。
その他の設定
C/C++test 一時ファイル
一時的なデータ ファイルを C/C++test が保持する場所を指定します。一時的なデータ/ファイルと は、インストゥルメントされたソース、コンパイルされたオブジェクト、リンクされたテスト用実行モジュール、自動生成ヘッダー ファイルなどです。 この設定は {cpptest:testware_loc}
を制御します。
C/C++test はこれらのファイルを必要に応じて自動的に再生成できるため、これらのファイルをチーム メンバー間で共有する必要はありません。したがって、これらのファイルをプロジェクトと共に保存したりソース管理システムに追加したりするべきではありません。
[消去] ボタンをクリックすると一時データを削除できます。ただし、テスト実行とテスト実行の間に一時データを削除しないことを推奨します。一時データを保持しておくと、パフォーマンスを大幅に向上させることができます。
なお、最適なパフォーマンスを得るには、ローカル ハード ドライブを使用してください。
詳細オプション
詳細オプションでは、さまざまな低水準オプションとデバッグ オプションを指定できます。利用可能なオプションについては「インストゥルメントの詳細オプション」を参照してください。
ソース ファイル エンコーディング
ソース ファイルをプロセスするときにマルチバイト エンコーディングを使用するかどうかを指定します。デフォルトは [自動 (オン)] であり、現行システムのエンコーディングに基づいて自動的にマルチバイト文字のサポートがアクティブになります。マルチバイト文字のサポートを手動で設定するには、[オン] または [オフ] を選択します。
なお、マルチバイト文字のサポートを有効にしてコードを解析すると、 パフォーマンスに影響する場合があるので注意してください。
スコープ設定
テスト対象から除外するプロジェクト ファイルを指定できます。詳細については「特定のリソースのテスト」を参照してください。