このセクションでは、C++test 6.x のテスト資産を C++test 10.x に移行する方法について説明します。

このセクションの内容

テストコンフィギュレーション

C++test 6.x からテストコンフィギュレーションをインポートするには、次の操作を行います。

(推奨) C++test 6.x のテストコンフィギュレーションのユーザー定義ルールに C++test 10.x からアクセスできること ( つまり Team Server で共有していること) を確認します。
[Parasoft] メニューの [ テストコンフィギュレーション] をクリックします。
[ユーザー定義] カテゴリを右クリックし、ショートカットメニューの [C++test 6.x テストコンフィギュレーションのインポート] をクリックします。ファイル選択用ダイアログで適切な C++test 6.x テストコンフィギュレーションファイル (.tcfg ファイル) を選択します。

C++test 6.x のテストコンフィギュレーションと同じ名前でユーザー定義テストコンフィギュレーションが作成されます。次のデータが C++test 6.x のテストコンフィギュレーションからインポートされます。

静的解析ルールの状態 ( 有効/ 無効)
有効な静的解析ルール。C++test 6.x のビルトイン静的解析ルールは、現行バージョンのビルトイン静的解析ルールにマップされます。ただし、C++test 6.x と現行バージョンとでは、ルールの識別子、メッセージ、重要度レベルが異なります。カスタムルール名を指定するとき、たとえば <rule_category>-<rule_unique_id> (myrule-123, user-456) のように、ハイフン "-" を使ってルールカテゴリとルール ID を区切ることを推奨します。そうすると、 C++test はルールカテゴリに基づいて自動的にルールツリー構造を作成します。
単体テストの生成の状態 ( 有効/ 無効)
生成されるテストケースの最大数
テストケースの結果を事後条件として表示
アサーションテンプレートの自動挿入
テストオブジェクトのメモリ割り当て ( スタックまたはヒープ)
入力値に経験則を使用する
派生クラスのオブジェクトを使用する
グローバル変数を初期化する
単体テストの実行の状態 (有効または無効)
テストケースのタイムアウト時間
カットオフ日の後に作成または変更されたファイルだけをテストする

その他のすべてのパラメーターはデフォルトに設定されます。
C++test 6.x テストコンフィギュレーションで有効だったルールに C++test 10.x がアクセスできない場合、警告メッセージが表示されます。
UNKNOWN カテゴリに追加されたルールは、ルールマッピングを使ってカテゴリを変更できます。詳細については「ルールカテゴリ、ID、ヘッダー、重要度レベルの変更」を参照し
てください。
Team Server に格納されたテストコンフィギュレーションを移行するには、 User フォルダーにインポートしてから、 C++test 10.x 形式で Team Server に再度アップロードします。

ソーステストのテストスイート

C++test 6.x から「ソーステスト」のテストスイートをインポートする方法は 2 つあります。すべてのテストスイートを 1 つのディレクトリにインポートする方法と、各 C++test 6.x テストユニットのテストスイートを個別のサブディレクトリにインポートする方法です。
テストスイートをインポートする前に、次の点に注意してください。

6.x プロジェクトにシンボルデータがなければなりません (「シンボルの読み込み」アクション)
C++test 10.x プロジェクトに、6.x プロジェクトと同じ ( 物理的) ソースファイルがなければなりません。「論理的」プロジェクトレイアウトは異なってもかまいません ( つまり、リンクされたディレクトリなどを使用できます)。
テストユニットまたはグローバルシンボルレベルで複数ファイル単位に対して作成された「インクルード」テストスイートはインポートされません。

C++test 6.x プロジェクトからテストスイートをインポートするには、次の操作を行います。

1. ショートカットメニューの [Parasoft] > [ ウィザード] > [C++test 6.x テストスイートをインポート] をクリックします。ウィザードが表示されます。

2. [C++test 6.x プロジェクトファイル] フィールドで、C++test 6.x プロジェクトファイルの場所を指定します。プロジェクトファイルの拡張子は .cpf でなければなりません。

3. [インポートされるテストスイートの場所] ドロップダウンリストから、すべてのテストスイートを 1 つのディレクトリにインポートするのか、それとも各 C++test 6.x テストユニットのテストスイートを個別のディレクトリにインポートするのかを指定します。そして、表示されたテキストを変更してテストスイートの保存先を指定します。次の変数を使用できます。

- ${src_file_name} - コンテキストファイルの名前。「コンテキストファイル」とは、テスト対象関数が定義されているコンパイル単位を表すソースのことです。
- ${src_file_base_name} - Nコンテキストファイルの名前 ( 拡張子なし)。
- ${src_file_ext} - コンテキストファイルの拡張子。
- ${src_file_loc_rel} - コンテキストファイルの場所 ( プロジェクトからの相対)
- ${src_file_uid} - コンテキストファイルの一意な識別子
- ${unit_name} - インポートするテストスイートの C++test 6.x テストユニット

4. 必要に応じて次のオプションを変更します。

- 複製されたテストスイートの名前を自動的に変更する このチェックボックスをオンにすると、ターゲットプロジェクトの別のテストスイートと名前が競合する場合、インポートするテストスイートの名前が自動的に変更されます。
- 複製されたテストスイートファイルの名前を自動的に変更する このチェックボックスをオンにすると、ターゲットプロジェクトの別のテストスイートファイルと名前が競合する場合、インポートするテストスイートファイルの名前が自動的に変更されます。

テストスイートまたはテストスイートファイルの名前が自動的に変更される場合、適切な情報がインポートされるテストスイートファイルに追加されます。
例：

// Test suite was renamed by C++test - original name: TestSuite_XX // File was renamed by C++test - original file: TestSuite_XX.cpp

名前の変更についての情報は C++test コンソールにも表示されます。
例：

Importing test suite "TestSuite_XX" ... ...warning, test suite "TestSuite_XX" already exists in the project. Test suite renamed to "TestSuite_XX_1".

5. [ 終了] をクリックします。

テストケースのインポート中、進行状況が [ コンソール] ビューに表示されます。進行状況の情報には、インポートされたテストスイート、インポート中に発生した問題、およびインポートのサマリが含まれます。
インポートプロセスの最中、C++test は __CPTR_Construct_Argument を使って古いコンストラクターのテストケースをチェックします。発見された古いコンストラクターの呼び出しは、デフォルトのコンストラクター呼び出しに変更されます。テストケースには適切な情報が保持され、元のコードはコメントアウトされます。警告メッセージが C++test コンソールに表示されます。インポートされたテストスイートファイルは、ユーザーがレビューするべきです。必要に応じて、異なるコンストラクターを使用するようにテストケースを変更してください。

ネイティブテスト

適切なライセンス機能を有効にしている場合、C++test 2.3 / 6.x のネイティブテストをインポートすることができます。ネイティブテストに関連するすべての設定項目を有効にするには、このライセンスが必要です ( たとえば、テストケースエクスプローラーの [ 新規追加] > [ ネイ
ティブテスト] ショートカットメニュー、テストコンフィギュレーションのオプション、C++test プロジェクトプロパティにおけるネイティブテストプロジェクト構成などです)。

C++test 6.x から C++test 10.x にネイティブテストをインポートするには、次の操作を行います。

C++test 6.x でテストされたすべてのソースファイルを含むプロジェクトを新規作成します。詳細については「プロジェクトの作成」を参照してください。
プロジェクトを適切に構成します。詳細については「プロジェクトとファイルのオプション設定」を参照してください。
次の操作を行ってネイティブテストをインポートします。
1. [Parasoft] メニューの [ビューの表示] > [テストケースエクスプローラー] をクリックしてテストケースエクスプローラーを表示します。
2. テストに追加するプロジェクトを右クリックし、ショートカットメニューの [新規追加] > [ネイティブテスト] をクリックします。
3. 表示されたファイル選択用ダイアログで、ネイティブテストを格納した C++test6.x プロジェクトファイル (.cpf ファイル) を選択し、[開く] ボタンをクリックします。

既存のネイティブテストが [テストケースエクスプローラー] ビューに自動的に追加されます。ネイティブテストは次の階層で表示されます。

[NewProject]
[Native Tests (OldProject.cpf)]
[File1.cpp]
    [Class1]
      [Function1]
        [TestCase1]
        [TestCase2]

Parasoft C/C++test Professional 10.4.1 for Visual Studio (Japanese) > Migrating test assets from C++test 6.x > TestCaseExplorer.png

テストの更新

新しいテストケースは、C++test 10.x の機能を使って追加するべきです。ネイティブテストケースを変更する必要がある場合、C++test 6.x で変更してから、テストケースエクスプローラーをリフレッシュして同期を取ることができます。

テストの実行

現行バージョンの C++test でネイティブテストを実行するには、次の操作を行います。

適切なテストコンフィギュレーションを作成します。次の操作を行います。

[Parasoft] メニューの [テストコンフィギュレーション] をクリックします。
[ユーザー定義] ノードを右クリックし、ショートカットメニューの [インポート]をクリックします。
<INSTALL_DIR>/configs/NativeTests の下にあるテストコンフィギュレーションを選択して [開く] ボタンをクリックします。
C++test 2.3/6.x のインストールディレクトリを指すよう'CPPTEST_INSTALL_DIR' 環境変数を設定します。
- たとえば、bash シェルで次のコマンドを使用したり、export CPPTEST_INSTALL_DIR=.... あるいは Windows の場合、[ コントロールパネル] > [ システム] > [ 詳細設定] の [ 環境変数] ボタンをクリックし、システム環境変数を設定します。
テストコンフィギュレーションの [ 実行] > [ 全般] タブで [ 実行コマンド]フィールドのコマンドラインパラメーターを検証し、必要に応じて修正します。

ネイティブテストを実行するようテストコンフィギュレーションを構成するには、次の操作を行います。

[実行] タブで [ テスト実行を有効にする] チェックボックスをオンにします。
[実行] > [ 全般] タブで [ レガシーネイティブテストケースを実行] チェックボックスをオンにします。
[実行コマンド] フィールドで、C++test 2.3/6.x 実行モジュールへの適切なパスを指定します。

2. テストケースエクスプローラーで、実行するテストを選択します。

3. ネイティブテストを実行するために作成したテストコンフィギュレーションを実行します。

注意:

ネイティブテストは、( スタブ、データソース、テストオブジェクトなどがある) オリジナルの環境を使って実行されます。
C++test 10.x は、コマンドラインモードで C++test 6.x を自動的に起動します。
C++test 10.x はテストと行カバレッジの結果を自動的にロードします。
ネイティブテストをそのオリジナルの環境で実行するには、オリジナルの C++test 6.x プロジェクトだけでなく、C++test 6.x も必要です。
コマンドライン実行もサポートされます ( 指定の C++test 10.x プロジェクトに関連付けられたすべてのネイティブテストが実行されます)。

結果の参照

ネイティブテストの実行結果は、ソーステストと同じように表示されます。

実行の詳細を参照するには、テストケースエクスプローラーを使用します。次の項目が表示されます。
- カラー表示された成功/ 失敗のステータス
- 実行の統計
検出された問題の詳細については、[ 品質タスク] ビューを参照します。次の項目が表示されます。
- 例外とスタックトレース
- 期待される値との不一致
カバレッジの詳細については、[ カバレッジ] ビューを参照します。次の項目が表示されます。
- ネイティブテストの行カバレッジ

また、次の操作も行うことができます。

コードエディターを開いて、カバーされた行/ カバーされなかった行を分析する。
レポートを作成する。
結果を Team Server にパブリッシュしてチームで共有する
結果を DTP にパブリッシュする (「DTP との接続」を参照)

制限事項

ネイティブテストは、選択したファイル、テストスイート、またはプロジェクトに基づいて実行することができます。ネイティブテストを個別に選択して実行することはできません。
ネイティブテストでは行カバレッジデータだけが取得されます。他のカバレッジメトリクスは利用できません。

スタブ

C++test 6.x からユーザースタブをインポートする方法は 2 つあります。すべてのユーザースタブを 1 つのファイルにインポートする方法と、各 C++test 6.x テストユニットのユーザースタブを個別のファイルにインポートする方法です。
C++test 6.x プロジェクトからユーザースタブをインポートするには、次の操作を行います。

1. [Parasoft] メニューの [ ウィザード] > [C++test 6.x ユーザースタブのインポート] をクリックします。

ウィザードが表示されます。

2.[C++test 6.x プロジェクトファイル] フィールドで、C++test 6.x プロジェクトファイルの場所を指定します。プロジェクトファイルの拡張子は .cpf でなければなりません。

3.

[ インポートされるスタブの場所] ドロップダウンリストからオプションを選択します。すべてのスタブを 1 つのディレクトリにインポートするのか、指定の C++test 10.x テストコンテキストのすべてのスタブを個別のサブディレクトリにインポートするのか、それとも指定の C++test 6.x テストユニットのすべてのスタブを個別のディレクトリにインポートするのかを選択します。

ファイルスコープモードで C++test 6.x の動作を C++test 10.x で再現する場合、[C++test9.x テストコンテキストのすべてのスタブを個別のサブディレクトリにインポートする] オプションが特に有効なことがあります。このオプションを使ってスタブをインポートすると、特定の C++test 9.x テストコンテキストのすべてのスタブが 1 つのディレクトリに配置されます。
ファイルスコープテストモードで適切なスタブがテストで必ず使用されるようにするには、次の操作を行います。

[Run Unit Tests (File Scope)] テストコンフィギュレーションをベースにしたユーザー定義テストコンフィギュレーションを作成します。
[ 実行] > [ シンボル] タブの [ プロジェクト内の他のファイルのシンボルを使用]フィールドで、コンテキスト固有のスタブだけを使用するよう指定します。
例：${project_loc}/stubs/imported/${ctx_name}

このように指定すると、ファイルスコープモードで foo.cpp ファイルをテストする場合、foo.cpp サブディレクトリにインポートされたスタブだけが使用されます。

4. [ 重複するスタブのインポートストラテジ] で、1 つの関数に対する複数のスタブのインポート方法を選択します。たとえば、ある関数のスタブが複数の C++test 6.x テストユニットのコンテキストで定義されている場合などです。次のオプションを選択できます。

- 重複するすべてのスタブをインポートする: 特別なアクションを実行することなく、1 つの関数のすべてのスタブをインポートします。
- 重複するスタブをコメントアウトする: 1 つの関数に対するスタブを 1 個だけインポートします。その関数の他のすべてのスタブは、インポート中にコメントアウトされます。
- 重複するスタブをマージする ( 同じ場所にインポートする場合): [インポートされるスタブの場所] の値を利用して、同じ関数に対する複数のスタブが 1 つのファイルに追加されます。C++test はすべてのスタブを 1 つのスタブ定義にマージしようとします。

5. 適切なテストコンテキストでスタブが必ず使用されるようインポートされるテスト定義を変更するには、[ スタブ定義と C++test 9.x のテストコンテキストを接続するコードを挿入する] チェックボックスをオンにします。
例：

   // [...]
     if (CppTest_IsCurrentContext("Examples/ATM/Source Files/Account.cxx")) {
     // [...]

このオプションは、[ 重複するスタブをマージする] を選択している場合に特に役立ちます。1 つのテスト定義が作成されます。このスタブ定義は、C++test 6.x スタブの動作に対応するテストコンテキストごとに異なった動作を行います。

double (::Account::CppTest_Stub_getBalance) ()
{
	if (CppTest_IsCurrentContext("/ATM/ATM/Account.cxx"))
	{
	//account
	}
	else if (CppTest_IsCurrentContext("/ATM/ATM/ATM.cxx"))
	{
	//atm
	}
	else
	{
		return getBalance();
	}
}

6.インポートされる各スタブファイルの先頭に特定のテキストを追加するには、[ 各スタブファイルの先頭にカスタムコードを挿入する] チェックボックスをオンにします。たとえば、インポートされるすべてのスタブファイルに、必要なヘッダーファイルの #include ディレクティブを追加することができます。

7. 重複するスタブをコメントアウトするには、[ 重複するスタブをコメントアウトする] チェックボックスをオンにします。

8. [ 終了] をクリックします。

スタブのインポート中、進行状況が [ コンソール] ビューに表示されます。進行状況の情報には、インポートされたスタブ、インポート中に発生した問題、およびインポートのサマリが含まれます。

C++test は、オリジナルソースファイル (C++test 6.x プロジェクトでスタブが作成されたファイル) から、インポートされるスタブファイルに #include ディレクティブを自動的にコピーします。

コマンドライン (cpptestcli) からの実行

C++test 6.x と C++test 10.x のコマンドラインの違いは次の表のとおりです。表中の「 x 」は、対応するコマンドがないことを表します。

C++test 6.x	C++test 10.x
`-Zicpf (file), --Zinput_cpf_project (file)`	`-data (WORKSPACE_DIR)`
`-Zocpf (file), --Zoutput_cpf_project (file)`	x
`-Zdsp (file), --Zdsp_project (file)`	x
`-Zvcproj (file), --Zvcproj_project (file)`	x
`-Zdc (name), --Zdsp_config (name)`	x
`-Zdc (name), --Zdsp_config (name)`	x
`-Zmcl (param), --Zmake_command_line (param)`	x
`-Ztf (name), --Ztest_file (name)`	`-resource (RESOURCE)`
`-Zeh (name), --Zexport_harness (name)`	x
`-Zrl (name), --Zread_logs (name)`	x
`-Ztc (name), --Ztest_config (name)`	`-config (CONFIG_URL)`
`-Zpc (name), --Zproject_config (name)`	x
`-Zso (file), --Zsave_options (file)`	x
`-Zitc (file), --Zimport_test_cases (file)`	x
`-Zito (file), --Zimport_test_objects (file)`	x
`-Zis (file), --Zimport_suppressions (file)`	x
`-Zrf (file), --Zreport_file (file)`	`-report (REPORT_FILE)`
`-Zgh (name), --Zgenerate_html (name)`	`-report (REPORT_FILE)`
`-Zhrd (dir), --Zhtml_report_directory (dir)`	`-report (REPORT_FILE)`
`-Zgx, --Zgenerate_xml`	`-report (REPORT_FILE)`
`-Zxrd (dir), --Zxml_report_directory (dir)`	`-report (REPORT_FILE)`
`-Zpr, --Zpublish_results`	`-publish, -publishteamserver`
`-Zf, --Zforce`	x
`-Zow {on\off}, --Zoverwrite {on\off}`	x
`-Zoe [quiet], --Zonly_errors [quiet]`	x
`-Zq, --Zquiet`	x
`-Zvm(level), --Zverbosity_mode(level)`	x
`-Zgrs {on\off}, --Zgrs {on\off}`	`-localsettings (LOCALSETTINGS_FILE)`
`-Zga (name), --Zgrs_attribute (name)`	`-localsettings (LOCALSETTINGS_FILE)`
`-Zcs, --Zcompile_source`	`x`
`-Zrs, --Zreread_symbols`	`x`
`-Zlc (param), --Zlist_config (param)`	`x`
`-Zecf, --Zexpand_command_files`	`x`
`-Znt --Zno_tests`	`x`
`-h, --help`	`-help`
`-V, --version`	`-version`
`x`	`-nobuild`
`x`	`-showdetails`
`x`	`-appconsole stdout`

テスト コンフィギュレーション

ソース テストのテスト スイート

ネイティブ テスト