...

• <INSTALL_DIR>/bin/cpptestcc - ビルド プロセスに統合し、カバレッジデータを収集できるようアプリケーションをインストゥルメントするカバレッジツールです。
  
• <INSTALL_DIR>/bin/engine/coverage/runtime - インストゥルメントされたアプリケーションに統合する必要があるカバレッジランタイム ライブラリです。

cpptestcc によるカバレッジの収集は、以下の 3 つのフェーズで行われます。

1. cpptestcc ツールをビルドに統合し、アプリケーションをインストゥルメントする。
2. インストゥルメントされたコードを実行し、raw カバレッジ データを収集する。
3. ビルトイン テスト コンフィギュレーションを使用して raw カバレッジ データを C/C++test にインポートし、C/C++test でカバレッジを確認する。

...

1. 
   <INSTALL_DIR>/bin へのパスを PATH システム変数に追加し、cpptestcc を実行できるようにします。

2. コンパイル コマンドを変更し、-- を区切り文字としたコンパイラコマンドの接頭辞としてcpptestcc実行モジュールを含めます。 例:
   

   元のコンパイル コマンド ライン

   Code Block
   cc -I app/includes -D defines -c source.cpp

   変更後のコンパイル コマンド ライン
   

   Code Block
   cpptestcc -compiler gcc_10-64 -line-coverage -- cc -I app/includes -D defines -c source.cpp

   Info
   cpptestcc ツールを利用するには、少なくとも以下のパラメーターがコマンドラインに設定されている必要があります。 - コンパイラ識別子-compiler <COMPILER_ID> - カバレッジメトリクス (例: -decision-coverage) その他のオプションについては、「cpptestcc コマンド ライン リファレンス」を参照してください。

3. リンカー コマンドを変更し、C/C++test に付属のビルド済みカバレッジランタイム ライブラリへのパスを指定して、アプリケーションにこのライブラリを追加します。例:
   

   元のコンパイル コマンド ライン
   

   Code Block
   lxx -L app/lib app/source.o somelib.lib -o app.exe

   変更後のコンパイル コマンド ライン
   

   Code Block
   lxx -L app/lib app/source.o somelib.lib [INSTALL_DIR]/bin/engine/coverage/runtime/lib/cpptest.lib -o app.exe

   Info
   icon false title 重要
   カバレッジ ランタイムのライブラリが共有 (動的ロード) ライブラリとしてリンクされる場合、インストゥルメントされたアプリケーションの開始時にカバレッジ ツールのライブラリを確実にロードできるようにする必要があります。通常は、 <INSTALL_DIR>/bin/engine/coverage/runtime/bin を PATH 環境変数に追加するか (Windows の場合)、または <INSTALL_DIR>/bin/engine/coverage/runtime/lib  を LD_LIBRARY_PATH 環境変数に追加する必要があります (Linux の場合)。

   Info
   icon false
   C/C++test には、Window および Linux のネイティブ アプリケーション用にビルド済みのカバレッジ ランタイム ライブラリが付属しています。クロスプラットフォームおよび組み込みテストの場合は、  <INSTALL_DIR>/bin/engine/coverage/runtime のソースからランタイム ライブラリをビルドする必要があります。 詳細は「カバレッジ ランタイム ライブラリ」を参照してください。

4. アプリケーションをビルドします。コードをインストゥルメントする際、cpptestccは .cpptest/cpptestcc フォルダーを作成します。ここには、重要なカバレッジ関連データ (「カバレッジ マップ」) が保存されます。デフォルトでは、フォルダーは現在のコンパイルの作業ディレクトリに作成されます。-workspace <path> オプションを使用してデフォルトの場所を変更できます。詳細は「cpptestcc コマンド ライン リファレンス」を参照してください。 
   
5. アプリケーションを実行します。cpptest_results.clogファイルにカバレッジ データ (「カバレッジ ログ」) が保存されます。
   
6. C/C++test がインストールされた IDE で、アプリケーションのすべてのソース ファイルを含む新規プロジェクトを作成します。
   ファイルおよびすべてのパスに変更がないことを確認します。
   
7. プロジェクトを選択し、IDE のメニューで [Parasoft] > [テスト コンフィギュレーション] > [Utilities] > [Load Application Coverage] をクリックしてカバレッジ データをインポートします (詳細は「カバレッジ データのインポート」を参照)。
   
8. カバレッジ情報を参照します (「Reviewing Coverage Information」を参照)。

...

C/C++test には、インクルードされたツールを実行するための Python スクリプトが付属しています。スクリプトは次の場所にあります。

<CPPTEST_INSTALL_DIR>/bin/engine/bin/cpptestpy.exe

MSBuild 統合スクリプトは次の場所にあります。

...

1. 1. CPPTEST_INSTALL_DIR 変数をセットアップします。

      Code Block
      set CPPTEST_HOME=<CPPTEST_INSTALL_DIR>

   2. PATH 変数をセットアップします。

      Code Block
      set PATH=%PATH%;%CPPTEST_HOME\bin\engine\coverage\runtime\bin

2. (CMake のみ) CMake を使用して MSBuild ファイルを生成します。 

   Code Block
   cd <PROJECT_DIR> mkdir build cd build cmake ..

3. 統合スクリプトを実行します。 

   Code Block
   <cpptestpy.exe> <msbuild_cpptest.py> -c -f project.vcxproj

4. MSBuild を使用してプロジェクトをビルドします。

   Code Block
   msbuild -t:Rebuild project.sln

5.  カバレッジを収集するには、ビルド ディレクトリに移動してプロジェクトを実行します。

   Code Block
   cd x64\Debug project.exe

   現在の作業ディレクトリにカバレッジ情報を含む .clog ファイルが作成されます。
   デフ ォルトのファイル名は cpptest_results.clog です。

6. カバレッジ レポートを生成します。

   Code Block
   cpptestcli.exe \ -data ../workspace \ -bdf cpptestscan.bdf \ -property bdf.import.location=BDF_LOC \ -config "builtin://Load Application Coverage"

Anchor
Command Line Reference for cpptestcc Command Line Reference for cpptestcc

cpptestcc コマンド ライン リファレンス

...

Linux (x86 および x86-64)

...

1. ビルド スクリプト内のリンカー コマンド ラインを特定します。

2. ビルド スクリプトを変更し、リンカー コマンド ラインの任意の場所にカバレッジ ランタイム ライブラリを指定します。できればすべてのオブジェクト ファイルの後に指定します。例:

   Code Block
   $(LXX) $(PRODUCT_OBJ) $(OFLAG_EXE)$(PROJ_EXECUTABLE) $(LXXFLAGS) $(SYSLIB) $(EXECUTABLE_LIB_LXX_OPTS) <INSTALL_DIR>/bin/engine/coverage/runtime/lib/cpptest.lib

3. PATH 環境変数に lib ディレクトリへのパスが追加され、テスト対象プログラム起動時にライブラリを発見できるようになっていることを確認します。cpptest.dll(またはcpptest64.dll) ファイルを実行モジュールと同じディレクトリ、またはテスト対象アプリケーションの起動時に動的リンク ライブラリを検索するその他の場所にコピーすることを検討するとよいでしょう。

...

1. ビルド スクリプト内のリンカー コマンド ラインを特定します。

2. ビルド スクリプトを変更し、リンカー コマンド ラインの任意の場所にカバレッジ ランタイム ライブラリを指定します。できればすべてのオブジェクト ファイルの後に指定します。例:

   Code Block
   $(LXX) $(PRODUCT_OBJ) $(OFLAG_EXE)$(PROJ_EXECUTABLE) $(LXXFLAGS) $(SYSLIB) $(EXECUTABLE_LIB_LXX_OPTS) -L <INSTALL_DIR>/bin/engine/coverage/runtime/lib -lcpptest

   -L および -lcpptest オプションが追加されていることに注意してください。

3. テスト対象実行モジュールが共有ライブラリへのパスを見つけられるよう、LD_LIBRARY_PATH 環境変数に lib ディレクトリへのパスが追加されていることを確認します。

...

cpptestcc -disable-auto-recovery-mode [...]

cpptestcc -coverage-data-variants [...]