このセクションの内容

はじめに

GNU make、CMake、QMake といったビルドツールを使用している場合、cpptestscan または cpptesttrace ユーティリティを使用して、C++test プロジェクトを作成することができます。これらのユーティリティは、プロジェクトを自動作成するために C++test が使用できる既存のコードのビルドプロセスから情報を収集します。ユーティリティが収集した情報を使って、プロジェクトをビルドして手動で構成することもできます。

ビルドデータファイルの概念

作業ディレクトリ、コンパイルのコマンドラインオプション、オリジナルビルドのリンクプロセスといったビルド情報は、「ビルドデータファイル」というファイルに保存されます。以下のサンプルはビルドデータファイルからの抜粋です。

------- cpptestscan v. 9.4.x.x -------
working_dir=/home/place/project/hypnos/pscom
project_name=pscom
arg=g++
arg=-c
arg=src/io/Path.cc
arg=-Iinclude
arg=-I.
arg=-o
arg=/home/place/project/hypnos/product/pscom/shared/io/Path.o

ビルドデータファイルは、プロジェクトのソースファイル、コンパイラの実行ファイル、コンパイラオプション、リンカーの実行ファイル、およびプロジェクトをビルドするために使用されるオプションについての情報のソースとして使用できます。ビルドデータファイルを使ってプロジェクトを作成するには、以下の 3 種類の方法があります。

プロジェクトのオプションソースとして [ビルドデータファイルのオプションを使用] を手動で設定し、適切なビルドデータファイルを選択する (「GUI からの C++test プロジェクトの作成」を参照)。
GUI を使ってプロジェクトを自動的にインポートする(「GUI ウィザードで BDF ファイルをインポートしてプロジェクトを作成する」を参照)。

コマンドラインを使ってプロジェクトを自動的にインポートする (「コマンドラインからインポートする」を参照)。

以下の条件に当てはまる場合、必要な環境変数もビルドデータファイルに格納できます。

コンパイラとリンカーが適切に動作するよう、必要な環境変数をビルドシステムがセットアップする。
C++test を実行するときに、その環境ではこれらの変数を使用できない。

以下の --cpptestscanEnvInOutput オプションの説明を参照してください。

`cpptestscan` または `cpptesttrace` を使ってビルドデータファイルを作成する

cpptestscan および cpptesttrace の実行ファイルは C++test インストールディレクトリの下にあります。これらのユーティリティは、既存のコードのビルドプロセスから情報を収集し、その情報を使ってビルドデータファイルを生成し、各実行についての情報をファイルに追加します。

cpptestscan ユーティリティは、標準ビルド中にコンパイラあるいはリンカーのラッパーとして使用されます。既存のコードで cpptestscan を使用するには、コンパイラ/ リンカーの実行ファイルの接頭辞として cpptestscan を指定してコードをビルドします。これは次の 2 つの方法で実行できます。

コンパイラ/ リンカーの実行ファイルのラッパーとして cpptestscan を呼び出すようにビルドコマンドを変更する。
コマンドラインでコンパイラ変数を上書きしたくない場合 (または上書きできない場合)、実際の Makefile またはビルドスクリプト中に cpptestscan を埋め込む。

既存のコードで cpptesttrace を使用するには、コンパイラ/ リンカーの実行ファイルの接頭辞として cpptesttrace を指定してコードをビルドします。cpptesttrace は、ビルド中に実行されたコンパイラとリンカーのプロセスをトレースし、トレースした内容をビルドデータファイルに格納します。

どちらの場合も、PATH 環境変数に C++test インストールディレクトリを追加するか、 cpptestscan または cpptesttrace ユーティリティへのフルパスを指定する必要があります。

cpptestscan と cpptesttrace で使用できるオプションは、以下の表のとおりです。オプションは、cpptestscan コマンドに直接指定するか、環境変数を介して指定できます。コマンドラインの接頭辞を変えることで、ほとんどのオプションが cpptestscan または cpptesttrace に適用できます。

基本的な cpptestscan の使用法:

Windows: cpptestscan.exe [options] [compile/link command]
Linux: cpptestscan [options] [compile/link command]

基本的な cpptesttrace の使用法:

Windows: cpptesttrace.exe [options] [build command]
Linux: cpptesttrace [options] [build command]

オプション	環境変数	説明	デフォルト
-- cpptestscanOutputFile= <OUTPUT_FILE> -- cpptesttraceOutputFile= <OUTPUT_FILE>	CPPTEST_SCAN_OUTPUT_FILE)	ビルド情報を追加するファイルを定義します。	cpptestscan.bdf
`--` `cpptestscanProjectNam` `e=<PROJECT_NAME>` `--` `cpptesttraceProjectNam` `e=<PROJECT_NAME>`	CPPTEST_SCAN_PROJECT_NAME	C++test プロジェクトの名前を定義します。	現在の作業ディレクトリ名
`--` `cpptestscanRunOrigCm` `d=` `[yes\|no]` `--` `cpptesttraceRunOrigCm` `d=[yes\|no]`	CPPTEST_SCAN_RUN_ORIG_CMD	yes の場合、オリジナルコマンドラインが実行されます。	yes
`--` `cpptestscanQuoteCmdLi` `neMode=[all\|sq\|none]` `--` `cpptesttraceQuoteCmdL` `ineMode=[all\|sq\|none]`	CPPTEST_SCAN_QUOTE_CMD_LINE_MODE	C++test がコマンドラインの実行を準備するときに、どのようにパラメーターを引用符で囲むかを指定します。 `all`: すべてのパラメーターが引用符で囲まれます。 `none`: どのパラメーターも引用符で囲まれません。 `sq`: 空白文字または引用符号があるパラメーターだけを引用符で囲みます。 cpptestscanQuoteCm dLineMode はLinux ではサポートされません。	all
`--` `cpptestscanCmdLinePre` `fix=` `<PREFIX>` `--` `cpptesttraceCmdLinePre` `fix=<PREFIX>`	CPPTEST_SCAN_CMD_LINE_PREFIX	[empty] ではなく、かつオリジナル実行ファイルの実行がオンの場合、指定のコマンドがオリジナルコマンドラインの前に付けられます。	[empty]
`--` `cpptestscanEnvInOutput` `=[yes\|no]` `--` `cpptesttraceEnvInOutput` `=[yes\|no]`	CPPTEST_SCAN_ENV_IN_OUTPUT	yes の場合、選択した環境変数とコマンドラインパラメーターが出力ファイルにダンプされます。さらに詳しく設定するには --cpptestscanEnvFile または--cpptestscanEnvars オプションを使用します。	no
`--` `cpptestscanEnvFile=<E` `NV_FILE>` `--` `cpptesttraceEnvFile=<E` `NV_FILE>`	CPPTEST_SCAN_ENV_FILE	有効な場合、指定したファイルにはすべてのビルドコマンドに共通の環境変数が保持されます。メインの出力ファイルは差分だけを保持します。メインの出力ファイルのサイズを縮小するには、このオプションを使用します。– cpptestscanEnvInOutを有効にしてこのオプションを使用してください。	[empty]
`--` `cpptestscanEnvars=[\|<` `ENVAR_NAME>,...]` `--` `cpptesttraceEnvars=[\|<` `ENVAR_NAME>,...]`	CPPTEST_SCAN_ENVARS	ダンプする環境変数名を指定するか、'*' を選択してすべての環境変数を指定します。 --cpptestscanEnvInOutput を有効にしてこのオプションを使用してください。	*
`--` `cpptestscanUseVariable` `=[VAR_NAME=VALUE,...]` `--` `cpptesttraceUseVariable` `=[VAR_NAME=VALUE,...]`	CPPTEST_SCAN_USE_VARIABLE	スキャンされたビルド情報中の各 "VALUE" 文字列を "${VAR_NAME}" 変数の使用で置き換えます。	[empty]
`--` `cpptesttraceTraceCommand`	CPPTEST_SCAN_TRACE_COMMAND	ビルドプロセス情報を収集するときにトレースするコマンド名を定義します。コマンド名は正規表現で指定します。コマンド名はビルドプロセスで使用されるオリジナルのコンパイラ/リンカーコマンドと一致しなければなりません。

例: cpptestscan を使用するように GNU make ビルドコマンドを変更する

make ベースのビルドで、コンパイラ変数が CXX であり、オリジナルコンパイラが g++ であるものとします。

make -f </path/to/makefile> <make target> [user-specific options] CXX="cpptestscan --cpptestscanOutputFile=/path/to/name.bdf --cpptestscanProjectName=<projectname> g++"

このコマンドは、通常と同じようにコードをビルドするだけでなく、指定されたディレクトリにビルドデータファイル (name.bdf) を生成します。

複数のディレクトリでビルドを実行する場合:

出力ファイルを指定しない場合、ソースビルドディレクトリごとに独自の .bdf ファイルが存在するべきです。この方法はソースディレクトリごとに 1 個のプロジェクトを作成するのに適しています。
ソースツリーごとにプロジェクトを用意したい場合、上記の例にあるように、1 個の .bdf ファイルを指定する必要があります。

例: cpptesttrace を使用するように GNU make ビルドコマンドを変更する

通常の make ベースのビルドでは次のコマンドを使用するものとします。

make clean all

次のコマンドラインを使用できます。

cpptesttrace --cpptesttraceOutputFile=/path/to/name.bdf --cpptesttraceProjectName=<projectname> make clean all

このコマンドは、通常と同じようにコードをビルドするだけでなく、指定されたディレクトリにビルドデータファイル (name.bdf) を生成します。

コンパイラあるいはリンカーのファイル名がデフォルトの cpptesttrace コマンドのパターンに一致しない場合、下記で説明する --cpptesttraceTraceCommand オプションを使ってカスタマイズする必要があります。'cpptesttrace --cpptesttraceHelp' コマンドを実行すると、デフォルトの cpptestscan コマンドのトレースパターンを見ることができます。

例: cpptestscan を使用するように GNU Makefile を変更する

Makefile でコンパイラ実行ファイルの変数として CXX を使用し、通常は CXX=g++ として定義している場合、変数を再定義することができます。

     ifeq ($(BUILD_MODE), PARASOFT_CPPTEST)
     CXX="/usr/local/parasoft/cpptestscan --cpptestscanOutputFile=<selected_location>/MyProject.bdf --cpptestscanProjectName=MyProject g++"
     else
     CXX=g++
     endif

次に、通常と同じようにビルドを実行し、make に BUILD_MODE 変数を追加します。

make BUILD_MODE=PARASOFT_CPPTEST

コードがビルドされ、ビルドデータファイル (MyProject.bdf) が作成されます。生成されたビルドデータファイルを使って、GUI またはコマンドラインからプロジェクトを作成することができます。

cpptestscan および cpptesttrace ユーティリティは、複数のコンパイラ実行ファイルを同時に実行できる並列ビルドシステムで使用できます。マルチコアマシンでビルドデータファイルを用意する場合、たとえば、-j <number_of_parallel_jobs> パラメーターを GNU make コマンドに渡すことで、より早くプロジェクトをビルドしてビルドデータファイルを用意できます。

例: CMake ビルドで cpptesttrace を使用する

CMake ベースのビルドがあり、cpptesttrace を使ってビルドデータファイルを生成できるものとします。

CMake を使って Makefile を生成するために、オリジナルの CMake コマンドを実行します。例:
cmake -G "Unix Makefiles" ../project_root
cpptestscan の環境変数を設定します。出力ファイルのパスには必ず絶対パスを使用します。
export CPPTEST_SCAN_PROJECT_NAME=my_project export CPPTEST_SCAN_OUTPUT_FILE=$PROJ_ROOT/cpptestscan.bdf
PATH 変数で cpptesttrace 実行ファイルが設定されていることを確認します。
プロジェクトのビルドを通常と同じにように実行します。ただし、ラッパーとして cpptesttrace を使用します。たとえば、通常のビルドコマンドが make clean all である場合、cpptesttrace を使ったコマンドは cpptesttrace make clean all となります。

CPPTEST_SCAN_OUTPUT_FILE 変数で定義された場所にビルドデータファイルが生成されます。この変数を設定していない場合、ビルドデータファイルは Makefile の場所に生成されます。

例: CMake ビルドで cpptestscan を使用する

すべてのスクリプトとコマンドは bash ベースです。別のシェルについては必要に応じて適合させてください。

CMake ベースのビルドがあるものとします。以下の操作を行って、cpptestscan を使ってビルドデータファイルを生成します。

コンパイラの接頭辞として cpptestscan を使用し、CMake を使って Makefile を再生成します。PATH 変数で cpptestscan の実行ファイルが設定されていることを確認してください。
1. オリジナルの CMake コマンドが cmake -G “Unix Makefiles” ../project_root である場合、既存の CMake のキャッシュを削除して cmake を実行し、コンパイラ変数を上書きします。次の例は、C コンパイラとして gcc を使用し、 C++ コンパイラとして g++ を使用するものとします。
  rm CMakeCache.txt CC="cpptestscan gcc" CXX="cpptestscan g++" cmake -G "Unix Makefiles" ../project_root
2. MakeCache.txt ファイルを参照して、CMAKE_*_COMPILER 変数が cpptestscan をポイントしているかどうかを確認します。
3. Makefile が再生成される場合、ステップ 5 に進みます。コンパイラが認識されなかったためにブートストラップのフェーズで cmake が失敗した場合、そのままステップ 2 に進みます。

以下の BASH スクリプトを作成して、CMake コンパイラのように振る舞う cpptestscan ラッパースクリプトを用意します。この例では、C コンパイラとして gcc を使用し、C++ コンパイラとして g++ を使用するものとします。

>cat cpptest_gcc.sh
#!/bin/bash
cpptestscan gcc --cpptestscanRunOrigCmd=no $* > /dev/null 2>&1 gcc $*
exit $?

>cat cpptest_g++.sh
#!/bin/bash
cpptestscan g++ --cpptestscanRunOrigCmd=no $* > /dev/null 2>&1 g++ $*
exit $?

1 番目のスクリプトは cpptestscan を起動し、コンパイラを実行せずにオプションを抽出します。2 番目のスクリプトは実際のコンパイラを実行します。その目的は、CMake によって「認められる」ためにスクリプト全体が見た目も動作もコンパイラのようになるためです。

2 つのスクリプトに実行可能属性を与えて共通の場所に置き、Makefile をスキャンする必要があるユーザーが皆スクリプトにアクセスできるようにします。PATH 変数に cpptestscan とスクリプトを必ず設定してください。
用意されたスクリプトから Makefile を再生成するオプションを使ってオリジナルの CMake コマンドを拡張します。CMake を使って、コンパイラとして使用されるスクリプトによって Makefile を再生成します。
- オリジナルの CMake コマンドが cmake -G “Unix Makefiles” ../project_root である場合、既存の CMake のキャッシュを削除して cmake を実行し、コンパイラ変数を上書きします。次の例は、C コンパイラとして gcc を使用し、 C++ コンパイラとして g++ を使用するものとします。
  rm CMakeCache.txt cmake -G "Unix Makefiles" -D CMAKE_C_COMPILER=cpptest_gcc.sh -D CMAKE_CXX_COMPILER=cpptest_g++.sh ../project_root
- CMakeCache.txt ファイルを参照し、用意されたラッパーを CMAKE_*_COMPILER 変数がポイントしているかどうかを確認します。
cpptestscan の環境変数を設定します。出力する .bdf ファイルを必ず絶対パスで指定してください。
export CPPTEST_SCAN_PROJECT_NAME=my_project export CPPTEST_SCAN_OUTPUT_FILE=$PROJ_ROOT/cpptestscan.bdf
どの make 変数も上書きすることなく、通常と同じようにプロジェクトビルドを実行します。 CPPTEST_SCAN_OUTPUT_FILE 変数で定義された場所にビルドデータファイルが生成されます。この変数を設定していない場合は Makefile の場所に生成されます。

デフォルトでは、CMake 生成の Makefile は、実行されたアクションについての情報だけを出力します。実際のコンパイラ/ リンカーのコマンドラインは出力しません。実行されたコンパイラ/ リンカーのコマンドラインを確認するには、make コマンドに “VERBOSE=1” を追加します。

他のビルドシステムでの cpptestscan または cpptestrace の使用

make ベースではないビルドシステムの場合も、cpptestscan と cpptesttrace の使用方法は上記の例と非常に似ています。通常、コンパイラはビルドスクリプト中のどこかで変数として定義されます。cpptestscan を使ってこのビルドシステムからビルドデータファイルを作成するには、オリジナルのコンパイラ実行ファイルに接頭辞として cpptestscan を付加します。cpptesttrace を使ってこのビルドシステムからビルドデータファイルを作成するには、ビルドコマンド全体に接頭辞として cpptesttrace を付加します。

いつ cpptestscan を使うべきか

ビルドデータファイルを準備する手続きをビルドシステムに統合することを強く推奨します。統合すると、通常のビルドを実行するときに、別のアクションを実行することなく、ビルドデータファイルを生成することができます。

それには、Makefile またはビルドスクリプトで、コンパイラとリンカーの実行ファイルに接頭辞として cpptestscan を付加します。

いつ cpptesttrace を使うべきか

Makefile / ビルドスクリプトを変更できない場合、またはビルドコマンドラインからコンパイラ/ リンカーの実行ファイルに接頭辞を付加するのがあまりにも複雑な場合、ビルドコマンド全体の接頭辞として cpptesttrace を使用します。

GUI ウィザードで BDF ファイルをインポートしてプロジェクトを作成する

C++test でテストしたいプロジェクトのビルドデータファイルを cpptestscan または cpptesttrace で作成したら、プロジェクト作成ウィザードを使って C++test プロジェクトを作成できます。

カスタムコンパイラを使用している場合、GUI ウィザードを開く前に、カスタムコンパイラを追加してください。詳細については「カスタムコンパイラを使用するテストの設定」を参照してください。

ビルドデータファイルからプロジェクトを作成するには、次の操作を行います。

[ファイル] メニューの [新規] > [その他] をクリックし、[C++test] > [ビルドデータファイルからプロジェクトを作成] を選択して [次へ] ボタンをクリックします。ウィザードの最初の画面が表示されます。
次の設定を行った後、[次へ] ボタンをクリックします。
- ビルドデータファイル 作成したビルドデータファイルの場所を入力します (ビルドデータファイルの作成については「cpptestscan または cpptesttrace を使ってビルドデータファイルを作成する」を参照)。
- プロジェクトの場所 インポートしたプロジェクトの保存先を指定します。ワークスペースまたは外部の場所を指定できます。ワークスペースを指定した場合、プロジェクトはワークスペース内のサブディレクトリに作成されます。外部の場所を指定した場合、インポートするプロジェクトが 1 つであれば、その場所の直下にプロジェクトが作成されます。インポートするプロジェクトが複数の場合、指定の場所にプロジェクトごとにサブディレクトリが作成されます。
  - 利用可能なプロジェクト作成オプションとその影響については、「C++test プロジェクトでの作業」を参照してください。
- コンパイラ設定 コンパイラの種類を指定します。その他のオプションは自動的に設定されます。
  - 有効なコンパイラの種類の値のリストを取得するには、 cpptestcli コマンドの -list-compilers スイッチを使用します。
作成されるプロジェクトのツリー構造が表示されます。プロジェクトの構造と内容を検証し、必要に応じて修正します。そして [次へ] ボタンをクリックします。
- 第 1 レベルには、作成されるすべてのプロジェクトが表示されます。プロジェクトの名前を変更したりプロジェクトへのフォルダーをさらにリンクしたりするには、プロジェクト名を右クリックして適切なショートカットメニューコマンドを実行します。
- 第 2 レベルには、リンクされるすべてのフォルダーが表示されます。フォルダーの名前を変更したり、プロジェクトから除外したりするには、フォルダー名を右クリックして適切なショートカットメニューコマンドを実行します。
- 第 3 レベル以降には、リンクされたフォルダー中のすべてのフォルダーおよびファイルが表示されます。緑色のチェックマークは、 .bdf ファイルから参照されるファイルを表します。
(オプション) 必要に応じてパス変数を指定します。そして [次へ] ボタンをクリックします。
- リンクされたフォルダーでパス変数を使用するには、[パス変数を使用してリンクされたフォルダーの場所を定義する] チェックボックスをオンにします。
- 定義済みのパス変数を使用する場合、[パス変数リスト] から選択します。
- カスタムパス変数を使用する場合、[パス変数リスト] から [カスタム] を選択してパス変数名とパス変数値をそれぞれ入力します。

[終了] ボタンをクリックします。指定の場所に指定のプロジェクトが作成されます。作成されたプロジェクトには、オプションがスキャンされたすべてのソースファイルが含まれます。また、プロジェクトのプロパティが適切に設定されているはずです。

コマンドラインからプロジェクトを作成する

コマンドラインからビルドデータファイルベースのプロジェクトを作成することもできます。-bdf <cpptestscan.bdf> スイッチを cpptestcli に渡します。

プロジェクトの作成直後に、たとえば静的解析やテスト生成などの解析を実行したい場合、-config を使用して、目的のテストコンフィギュレーションを指定します。例:

cpptestcli -data "</path/to/workspace>" -resource "<projectname>" -config "team://Team Configuration" -localsettings "</path/to/name.properties>" -bdf "</path/to/name.bdf>"

解析を実行せずに単純にプロジェクトを作成したい場合、 -config オプションを省略します。例:

cpptestcli -data "</path/to/workspace>" -resource "<projectname>" -localsettings "</path/to/name.properties>" -bdf "</path/to/name.bdf>"

過去のバージョンの C++test では、テストを実行せずにプロジェクトを作成するために -config "util/CreateProjectOnly" を使用しました。現行バージョンの C++test はこのオプションをもう使用しません。偽のテストコンフィギュレーション "util/CreateProjectOnly" はもうサポートされません。

カスタムプロジェクト設定は、プレーンテキストのオプションファイルで設定できます。-localsettings スイッチを使ってオプションファイルを cpptestcli に渡します。詳細については「ローカル設定ファイル (オプションファイル)」を参照してください。

例

ここでは、cpptestscan を使ってコマンドラインから C++test プロジェクトを作成する方法について説明します。この例では C++test の ATM サンプルを使用します。このサンプルは <INSTALL_DIR>/Examples/ATM ディレクトリにあります。

この例では make ベースのビルドを使用しますが、ビルドデータファイル (.bdf ファイル) はどのビルドシステムからも生成できます。

仮定と前提

cpptestscan の実行ファイルが $PATH 変数に指定されているものとします ( cpptestscan の実行ファイルは、C++test のインストールディレクトリにあります)。
cpptestcli の実行ファイルが $PATH 変数に指定されているものとします ( cpptestcli の実行ファイルは、C++test のインストールディレクトリにあります)。
g++ がオリジナルコンパイラの実行ファイルであるものとします。
ワークスペースおよび .bdf ファイルの場所は、shell/ コマンドプロンプトがサポートする形式で入力する必要があります。例:
- /home/MyWorkspace on UNIX/Cygwin
- c:\home\MyWorkspace on Windows
- c:/home/MyWorkspace on Cygwin
テストを実行せずにプロジェクトを作成するには、-config を省略します。
新規にプロジェクトを作成してテストを実行するには、適切なテストコンフィギュレーションを使用します。 ( 例： -config MustHaveRules)
make の実行ですべてのオブジェクトが確実にビルドされるよう、完全なプロジェクトのリビルド (clean all) が実行されます。

例 1 - デフォルトの設定でワークスペースの場所に C++test プロジェクトを作成する

オリジナルの Makefile をベースにして、ビルドデータファイル (.bdf ファイル) を作成します。
1. <INSTALL_DIR>/Examples/ATM ディレクトリに移動します。
2. オリジナルコンパイラの実行ファイル名の前に cpptestscan を付加して、ATM プロジェクトをビルドします:
  > make CC="cpptestscan g++" clean all
3. 新しいビルドデータファイル (cpptestscan.bdf) が <INSTALL_DIR>/Examples/ATM ディレクトリに作成されたことを確認します。
ビルドデータファイルをベースにして、C++test プロジェクトを作成します。次の操作を行います。
1. コマンドライン cpptestcli を使って、新しいプロジェクトを /home/MyWorkspace ワークスペースに作成します。:
  > cpptestcli -data /home/MyWorkspace -bdf cpptestscan.bdf
2. 新しい C++test プロジェクト (ATM) が MyWorkspace に作成されました。このプロジェクトには、オリジナルの <INSTALL_DIR>/Examples/ATM プロジェクトのすべてのソースファイルとビルドオブジェクトが含まれます。

例 2 - Visual C++ 7.1 をコンパイラとして設定し、myProject をプロジェクトとして設定して、オリジナルプロジェクトの場所に C++test プロジェクトを作成する

オリジナルの Makefile をベースにして、ビルドデータファイル (.bdf ファイル) を作成します。
1. <INSTALL_DIR>/Examples/ATM ディレクトリに移動します。
2. オリジナルコンパイラの実行ファイル名の前に cpptestscan を付加して、ATM プロジェクトをビルドします:
  > make CC="cpptestscan --cpptestscanProjectName=myProject g++" clean all
3. 新しいビルドデータファイル (cpptestscan.bdf) が <INSTALL_DIR>/Examples/ATM ディレクトリに作成されたことを確認します。myProject がプロジェクト名として設定されている点に注目してください。
ビルドデータファイルをベースにして、C++test プロジェクトを作成します。次の操作を行います。
- まず、デフォルト設定をオーバーライドします。
  1. <INSTALL_DIR>/Examples/ATM に、opts.properties という名前でテキストファイルを作成します。
  2. opts.properties ファイルに bdf.import.compiler.family=vc_7_1 と入力して、コンパイラの種類に Visual C++ 7.1 をセットします。
  3. opts.properties ファイルに bdf.import.location=BDF_LOC と入力し、目的のプロジェクトの場所として cpptestscan.bdf ファイルがある場所を設定します (cpptestscan.bdf ファイルは、オリジナルプロジェクトのディレクトリにあります)。
- 次に、コマンドライン cpptestcli を使って、新しいプロジェクトを /home/MyWorkspace ワークスペースに作成します。
  cpptestcli -data /home/MyWorkspace -bdf cpptestscan.bdf -localsettings opts.properties
- 新しい C++test プロジェクト (myProject) が <INSTALL_DIR>/Examples/ATM に作成されました。このプロジェクトには、オリジナルの <INSTALL_DIR>/Examples/ATM プロジェクトのすべてのソースファイルとビルドオブジェクトが含まれており、コンパイラの種類として Visual C++ 7.1 がセットされています。

注意:

この例では、サポートされるコンパイラのリストにある vc_7_1 を使用しました。カスタムコンパイラを使用するには、[Parasoft] メニューの [設定] をクリックし、[コンフィギュレーション] > [カスタムディレクトリ] > [カスタムコンパイラ] でパスを指定します。詳細については「カスタムコンパイラを使用するテストの設定」を参照してください。
プロジェクトの場所として、BDF_LOC 変数を使用しました。この変数は cpptestscan.bdf ファイルの場所を参照します。

生成されたビルドデータファイルを使って、GUI またはコマンドラインからプロジェクトを作成することができます。