このセクションの内容

前提条件

インストール

以下の操作説明では、[INSTALL_DIR] はC/C++test のインストールディレクトリを指すものとします。このディレクトリのデフォルト名はcpptest です。

Parasoft カバレッジ機能をMS Build と統合するには、以下の操作を行います。

  1. [INSTALL_DIR] ディレクトリを指す CPPTEST_HOME 環境変数を追加します。
  2. PATH 変数に[INSTALL_DIR]/bin ディレクトリを追加して、cpptest.dll ライブラリに確実にアクセスできるようにします。
  3. [INSTALL_DIR]/integration/msbuild ディレクトリに移動します。
  4. Visual Studio ソリューションがあるディレクトリにparasoft-coverage.xml およびparasoft-coverage.props ファイルをコピーします。
  5. (任意) ソリューションディレクトリのparasoft-coverage.xml およびparasoft-coverage.props ファイルをソース管理システムに追加します。
  6. Visual Studio でソリューションを開きます。
  7. [表示] > [その他のウィンドウ] > [プロパティマネージャー] に移動します。
  8. カバレッジレポートを生成する対象として、ソリューションプロジェクトか、またはプロジェクトの特定のビルド構成を選択します。
    カバレッジの収集だけに使用する専用のビルド構成を作成すると良いでしょう。     
  9. 選択したプロジェクトまたは構成を右クリックして[既存のプロパティシートの追加…] を選択し、ソリューションディレクトリにあるparasoft-coverage.props ファイルを指定します。
    プロジェクトを選択した場合、parasoft-coverage.props ファイルはプロジェクト中のすべてのテスト構成に追加されます。上記の例の場合、parasoft-coverage.props ファイルはATM プロジェクトでは4 個のすべてのテスト構成に追加されますが、BugDetective プロジェクトでは選択した2 個の構成にのみ追加されます。 

設定

プロジェクト、構成、またはparasoft-coverage.props ファイルのプロパティページで、コードインストゥルメントを設定できます。

 コード インストゥルメントを設定するには、以下の操作を行います。 

  1. プロジェクト、構成、またはparasoft-coverage.props ファイルをダブルクリックしてプロパティページを開きます。
  2. プロジェクトレベルでプロパティページを変更する場合は、ドロップダウンメニューからテスト構成とプラットフォームを選択します。設定は、選択したテスト構成にのみ適用されます。

  3. [構成プロパティ] > [Parasoft DTP for C/C++] に移動し、ドロップダウンメニューから設定を選択します。

全般的な設定

名前値説明
Engine Location [path] 

C/C++test の場所を指定します。デフォルトは、CPPTEST_HOME 環境変数に設定されている値です。 

Compiler Configuration [complier configuration] コンパイラの構成を指定します。デフォルトは AutoDetect です。
Workspace Location [path] カバレッジレポートを生成するために使用するデータがあるディレクトリを指定します。デフォルトはソリューションディレクトリの場所です。 

カバレッジ設定

名前値説明
Line Coverage 

Yes

No

ビルド中にカバレッジの収集を有効にするか無効にするかを指定できます。デフォルトは「有効にする」です。 

詳細設定

名前値説明
Enable Coverage Optimization 

Yes

No

カバレッジの最適化を有効または無効にできます。有効の場合、実行時間のオーバーヘッドが削減されます。このオプションのデフォルトは「有効」です。 
Enable Optimized Coverage Corruption Detection 

Yes

No

最適化されたカバレッジ破損の検出を有効または無効にできます。[Coverage Optimization] オプションをYes に設定する必要があります。

有効の場合、破損したカバレッジメモリバッファーを検出することができます。これは[Coverage Optimization] が有効な場合に使用されます。このオプションのデフォルトは「無効」です。

Enable Coverage Early Initialization 

Yes

No

カバレッジの早期の初期化を有効または無効にできます。有効の場合、カバレッジの収集プロセスは自動的に開始します。無効の場合はカバレッジの収集プロセスを手動で開始しなければなりません。このオプションのデフォルトは「有効」です。

 カバレッジ収集を手動で初期化する方法の詳細については、Parasoft サポートにお問い合わせください。

Enable Coverage Auto-Finalization 

Yes

No

カバレッジの自動終了を有効または無効にできます。有効の場合、カバレッジ情報の収集プロセスは自動的に終了します。無効の場合は収集プロセスを手動で終了しなければなりません。このオプションのデフォルトは「有効」です。

カバレッジ収集を手動で終了する方法の詳細については、Parasoft サポートにお問い合わせください。

プロジェクトまたは構成のレベルで選択した設定が、parasoft-coverage.props レベルで指定した設定と異なる場合、プロジェクト/構成レベルの設定が優先されてビルド中に使用されます。特定のレベルで選択された設定は太字で表示されます。上位レベルから継承された設定は標準フォントで表示されます。

ビルドと実行

コード インストゥルメントされたアプリケーションをビルドし、実行モジュールの実行中にカバレッジ情報を収集するには、以下の操作を行います。

  1. [構成プロパティ] > [Parasoft DTP for C/C++] > [Coverage Settings] で行カバレッジが有効になっていることを確認します。
  2. Visual Studio ツールバーのドロップダウンメニューから、実行に使用する構成とプラットフォームを選択します。
  3. プロジェクトのクリーンビルドを実行します。
  4. ビルドした実行モジュールを実行します。実行モジュールは、コマンドラインから実行したり、Visual Studio デバッガーを使って実行したり、あるいはプロジェクトが必要とする他の方法で実行することができます。
  5. 現行の作業ディレクトリに、カバレッジ情報を含む.clog ファイルが生成されます。デフォルトのファイル名はcpptest_results.clog です。

レポート

コマンドラインまたはVisual Studio DTP Plugin for C/C++ から、カバレッジレポートを生成できます。

コマンドライン

  1. ソリューションディレクトリに移動します。

  2. Coverage ビルトインコンフィギュレーションを使ってcpptestcli.exe を実行します。入力として.clog ファイルを使用します。以下はコマンドの例です。

    cpptestcli.exe -config "builtin://Coverage" -input ATM/Debug/cpptest_results.clog

  3. ソリューションのreports サブディレクトリに生成されるXML とHTML のカバレッジレポートを確認します。 

    設定されたワークスペースの場所がデフォルトのソリューションディレクトリと異なる場合、-workspace スイッチを使って、ワークスペースの場所として指定されたディレクトリへのパスを指定します。

Visual Studio DTP Plugin for C/C++ 

  1. [Parasoft] > [オプション] > [Engine] をクリックします。
  2. [C/C++] が有効になっていることを確認します。

  3. [Arguments] フィールドに、実行を再設定するための新しいパラメーターを入力します。

  4. 選択したプロジェクトに対してCoverage ビルトインコンフィギュレーションを実行します。

  5. 実行が完了したら、ポップアップウィンドウで[レポートの生成] チェックボックスをオンにします。[構成…] リンクからレポート構成の設定を指定できます。
  6. Visual Studio のメインウィンドウで、生成されたレポートを参照します。

Parasoft の統合の削除

parasoft-coverage プロパティシートをアンインストールするには、以下の操作を行います。

  1. [表示] > [その他のウィンドウ] > [プロパティマネージャー] をクリックします。
  2. プロジェクトと構成を確認し、削除するparasoft-coverage.props ファイルを探します。このファイルは、個々の構成から手動で削除する必要があります。

  3. 選択したファイルを右クリックし、メニューから[削除] を選択します。

  4. 選択したプロジェクト構成からのみparasoft-coverage.props ファイルが削除されます。