このセクションでは、プロジェクト レベルおよびファイル レベルのオプション設定をカスタマイズ する方法について説明します。

このセクションの内容

オプション設定の参照と変更

C++test でコードを適切にテストするには、ビルド設定を正しく指定する必要があります。テスト環 境に合わせて Report Center とインストゥルメントのオプションも変更できます。

オプション設定を変更するには、次の操作を行います。

1. ソリューション エクスプローラー ツリー

    (「プロジェクト ツリー」と呼ばれます) でオプション設定を変更するプロジェクトまたはファイルのノードを右クリックし、ショート カット メニューの

    [Prasoft] >

   [ プロパティー] をクリックします。[ プロパティー] ダイアログが表示されます。

2. [Parasoft] > [C++test] カテゴリを展開します。
3. オプション設定を変更するカテゴリを選択します。各カテゴリで設定できるオプションにつ いては下記で説明します。
   • 必ず確認しなければならないのは「ビルド設定」です。
4. オプションを変更します。
5.  [ 適用] をクリックして [OK] をクリックします。

設定できるオプション

ビルド設定

• オプションのソース: オプションの設定方法を指定します。 

   

   

  • ビルド データ ファイルのオプションを使用   

    ,   「cpptestscan ユーティリティを使ってビルド データ ファイルを作成済みの場合」および「ビルド データ ファイルの再生成と更新を手動で管理したい場 合」、このオプションを推奨します。

     

  • ビルド システムのオプションを使用    「コマンドラインからプロジェクトをビルドできるが、ビルド データ ファイルを作 成していない場合」または「ビルド データ ファイルの再生成と更新を C++test に 任せたい場合」、このオプションを推奨します。
  • マネージド Make C/C++ プロジェクトのオプションを使用    Eclipse で開発した「マネージド Make プロジェクト」の場合、このオプションを推奨します。

  •  

[ オプション ソース] で選択した項目によって、表示されるオプションは異なります。

複数の C++test プロジェクト構成の管理

複数の C++test プロジェクト構成を使って、さまざまな構成のテストを管理することができます。たとえば、ホスト コンパイラ、クロス コンパイラ、デバッグ モードでのテスト、リリース モードでのテストなどに対してプロジェクトを構成できます。

また、現在のアクティブなプロパティをファイルにエクスポートしたり、以前に保存したプロパティをファイルからインポートすることもできます。

1. プロジェクト エクスプローラーでプロジェクトを右クリックし、[ プロパティ] をクリックします。
2. [Parasoft] > [C++test] を選択して [ エクスポート] または [ インポート] をクリックします。
3. プロパティを探して [ 保存] または [ 開く] をクリックします。

プロパティをエクスポートすると、cpptestcli -localsettings パラメーターで引数として使用できるファイルが作成されます。このファイルを利用して、コマンドラインからテストするときに別のプロジェクト構成に簡単に切り替えることができます。

プロジェクトのオプションを使用

次のオプションを設定します。

1. [ コンフィギュレーション] フィールドで、使用するコンフィギュレーションを選択します。
   • 利用可能なコンフィギュレーションのリストを更新するには [更新] をクリックします。
2. [ コンパイラ設定] で、C および C++ ソースのためのコンパイラの実行モジュール、リンカー、コンパイラファミリーを選択します。
3. [ オプション] で、Visual Studio 6 構成でまだ指定していない、テスト固有およびC++test 固有のコンパイラオプションとリンカーオプションを指定します。
   • 詳細については「コンパイラとリンカーのオプション設定 」を参照してください。

Visual C++ プロジェクトファイルオプションを変更した場合、C++test は自動的にオプションを再スキャンしてプロジェクトを適切に変更します。 

ビルド データ ファイルのオプションを使用

次のオプションを設定します。

1. [ ビルド データ ファイル] フィールドで、作成したビルド データ ファイルを指定します (ビルド データ ファイルの作成については「cpptestscan または cpptesttrace を使ってビルド データ ファイルを作成する」を参照)。
   •  絶対パスを使用すると、互換性のないプロジェクトになることがあります。次のC++test 変数を使ってパスを指定することを推奨します。
     • ${resource_loc} は、特定のプロジェクト リソースへのパスに解決します。たとえば、 ${resource_loc:/MyProject/linked_src_dir/source.cpp} はC:\src\source.cpp に解決します。
2. 毎回 C++test がオプションをスキャンするときに、前回のオプションを消去したい場合、[前回収集されたオプションを保持 ( インクリメンタル ビルド)] チェックボックスをオフにします。オンにした場合は、各ビルドがインクリメンタル ビルドとして処理されます。
   • インクリメンタル ビルドがある場合、ビルド データ ファイルからのオプションのスキャンが終了した後にビルド データ ファイルを削除するには、[ 処理終了後にビルド データ ファイルを削除] チェックボックスをオンにします。このオプションは、ビルドが実行されるたびにビルド データ ファイルが際限なく拡大するのを防止します。
3. [ コンパイラ設定] で、コンパイラの実行ファイル、リンカー、およびコンパイラの種類を指定します。
   • 使用しているコンパイラがリスト中にない場合、カスタム コンパイラ定義を追加します ( 詳細については「カスタム コンパイラを使用するテストの設定 」を参照)。
4. [ オプション] で、Makefile でまだ指定していない、テスト固有および C++test 固有のコンパイラ オプションとリンカー オプションを指定します。
   • 詳細については「コンパイラとリンカーのオプション設定」 を参照。

指定のビルド データ ファイル中でオプションが変更されると、C++test は自動的にオプションを再度スキャンして、変更に合わせてプロジェクトを修正します。たとえば外部コンフィギュレーション ファイルが変わったなどの理由でオプションを強制的にすぐに更新したい場合は、[ キャッシュをリセット] ボタンをクリックします。 

ビルド システムのオプションを使用

次のオプションを設定します。

1. [ ビルド コマンドライン] フィールドでオプションを確認します。C++test は、このオプ ションを利用して、ビルドの実行 ( たとえば makefile による make の実行) およびプロセ スからのプロジェクト ビルド オプションの収集を行います。
   • C++test は、[ ビルド コマンドライン] の指定に従って、適切な値を再割り当てし てコンパイラを置き換えます。
   • C++test オプション スキャナーは ${CPPTEST_SCAN} 変数で表されます。
2. C++test のデフォルトとは異なるコンパイラ/ リンカー変数を使用している場合、必要に応 じてビルド コマンドラインを変更します。
• 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++test は、適切な値を再割り当てしてコンパイラとリンカーを置き換えることが できる限り、任意のビルド プロセス ( nmake、ant、または任意のビルド スクリ プト) をサポートします。

       3. [ ビルド作業ディレクトリ] フィールドで、ビルド プロセスを実行するディレクトリを指定 します。

• • 絶対パスを使用すると、移植性がないプロジェクトになる可能性があります。次の C++test 変数の使用を推奨します。

    • ${project_loc} は、

       Visual Studio プロジェクト

      がある場所への絶対パスです。

      
      

      ${resource_loc} は、特定のプロジェクト リソースへの絶対パスです。たとえば、${resource_loc:/MyProject/linked_src_dir/source.cpp} は C:\src\source.cpp に解決されます。

4. [ 従属ファイル] フィールドで、変更をチェックする Makefile を指定します。指定したファ イルが変更された場合、オプションは自動的に更新されます。

• • • Eclipse プロジェクトへの絶対パスを使用すると、移植性がないプロジェクトになる 可能性があります。次の C++test 変数の使用を推奨します。

    • ${project_loc} は、は、

       Visual Studio プロジェクト

      がある場所への絶対パスです。 

    • ${resource_loc} は、特定のプロジェクト リソースへの絶対パスです。 たとえば、${resource_loc:/MyProject/linked_src_dir/source.cpp} は C:\src\source.cpp に解決されます。

5. [ コンパイラ設定] エリアで、C/C++ ソースのためのコンパイラの実行ファイル、リン カー、および種類を指定します。

• 使用しているコンパイラがリスト中にない場合は、カスタム コンパイラの定義を追 加してからコンパイラを選択してください。詳細については「カスタム コンパイラを使用するテストの設定 」 を参照してください。

6. [ オプション] エリアで、Makefile で指定していないテスト固有または C++test 固有のコ ンパイラ/ リンカー オプションを指定します。

• 詳細については 「コンパイラとリンカーのオプション設定」 を参照し てください。

[ 従属ファイル] フィールドで指定したファイルが変更されると、C++test は自動的にオプションを再スキャンしてプロジェクトを更新します。 

実行の設定 ( ファイル レベルのみ)

テスト ケースの実行中に、選択したソース ファイルをインストゥルメントするかどうかを指定しま す。

 複数のファイルにこの設定を適用するには、プロジェクトの中からファイルを選択して右クリック し、[Parasoft] > [C++test] > [ 実行の設定] を選択します。選択したすべてのファイルに現在の 設定が適用される点に注意してください。

Parasoft Project Center 属性

このプロジェクトまたはファイルからの結果を Parasoft Report Center でどのように分類してタグ付けするかを指定します。

詳細については「Project Center との接続」を参照してください。

その他の設定

C++test の一時ファイルの場所と詳細オプションを設定できます。

C++test 一時ファイル

一時的なデータ/ ファイルを C++test が保持する場所を指定します。一時的なデータ/ ファイルと は、インストゥルメントされたソース、コンパイルされたオブジェクト、リンクされたテスト用実行 モジュール、自動生成ヘッダー ファイルなどです。この設定は {cpptest:testware_loc} を制御します。

 C++test はこれらのファイルを必要に応じて自動的に再生成できるため、これらのファイルをチー ム メンバー間で共有する必要はありません。したがって、これらのファイルをプロジェクトと共に 保存したりソース管理システムに追加したりするべきではありません。

 [ 消去] ボタンをクリックすると一時データを削除できます。ただし、テスト実行とテスト実行の間 に一時データを削除しないことを推奨します。一時データを保持しておくと、パフォーマンスを大幅 に向上させることができます。

なお、最適なパフォーマンスを得るには、ローカル ハード ドライブを使用してください。

詳細オプション

詳細オプションでは、さまざまな低水準オプションとデバッグ オプションを指定できます。詳細に ついては「インストゥルメントの詳細オプション」を参照してください。

ソース ファイル エンコーディング

ソース ファイルをプロセスするときにマルチバイト エンコーディングを使用するかどうかを指定し ます。デフォルトは [ 自動 ( オン)] であり、現行システムのエンコーディングに基づいて自動的に マルチバイト文字のサポートがアクティブになります。マルチバイト文字のサポートを手動で設定す るには、[ オン] または [ オフ] を選択します。

なお、マルチバイト文字のサポートを有効にしてコードを解析すると、 パフォーマンスに影響する場 合があるので注意してください。

スコープ設定

テスト対象から除外するプロジェクト ファイルを指定できます。詳細については「特定のリソースのテスト」 を参照してください。