このセクションでは、 「コマンドライン インターフェイス (cli)」で説明されている C/C++test コマンドライン インターフェイス (cpptestcli) からテストを実行する方法について説明します。

このセクションの内容

前提条件

コマンドライン モードを使用するには、コマンドライン インターフェイスのライセンスが必要です (C/C++test Automation Edition に付属)。

• Automation Edition のすべての機能にアクセスするには、Parasoft Team Server のインストールと設定も必要です。 
• テストを開始する前に、「設定」の説明に従って C/C++test の環境設定を行うことを強く推奨します。

• コマンドラインからテストを実行するには、C/C++test のインストール ディレクトリをパスに設定する必要があります。 パスに設定しない場合は、c:\parasoft\c++test\cpptestcli.exe のように絶対パスで cpptest を実行する必要があります。C/C++test でコードをテストするには、Visual Studio プロジェクトにコードを追加する必要があります。「プロジェクトの作成」を参照してください。

• 初期テストを実行する前に、プロジェクト オプションを確認して変更することを強く推奨し ます。詳細については「ローカル設定ファイル (オプション ファイル)」を参照してください。

• cpptestcli から各開発者の作業に関連したエラー/ 結果だけを開発者に送信するには、次のいずれかの条件を満たす必要があります。

  • 「ソース管理システムのデータに基づいてコード作成者を算定するように C/C++test を設定している」かつ「ソース管理システムを使用している」かつ「ソース管理システムでの各開発者のユーザー名とメール ドメインが開発者の電子 メール アドレスに一致している」 ( メール ドメインはオプション ファイルおよび「-localsettings %LOCALSETTINGS_FILE%」で解説の -localsettings オプションを使って指定)

  • 「ローカル ユーザーに基づいてコード作成者を算定するように C/C++test を設定している」かつ 「ユーザー名およびメール ドメインが開発者の電子メール アドレスに一致している」 (メール ドメインはオプション ファイルおよび「-localsettings %LOCALSETTINGS_FILE%」で解説の -localsettings オプションを使って指定 )」

セットアップの概要

Parasoft C/C++test Professional には 2 つのユーザー モードがあります。インタラクティブにデスクトップで C++test を 使用する「GUI モード」とコマンドライン インターフェイスを介して実行する「コマンドライン」モードです。コマンドライン インターフェイスは Automation Edition の標準機能です。 

コマンドライン モードは通常、定期的/ 継続的なビルドまたは自動回帰テストのインフラストラク チャと連携して、定期的/ 継続的なコード解析とテストを実行するために使用します。C/C++test の コマンドライン インターフェイスは、 Visual Studio ソリューション全体、またはソリューションの一部である 1 つ以上のプロジェクトまたはソースファイルに対して実行できます。 コマン ドライン インターフェイスの実行の一部として、C/C++test は次の 1 つ以上のことを実行します。

• コードの静的解析。定義されたコーディング ポリシーのチェック、実行時のバグの可能性の解析、メトリクスの解析を含みます。

• 単体テストの実行(任意のソリューションで)

• SCM コード リポジトリの解析。最後の実行後のコードの変更を特定し、更新されたコード に対するコード レビュー セッションを開始します。
• レポートの生成と集約レポート サーバーへの送信。または開発者とマネージャーへの送信。 レポート設定での指定に従って送信されます。

実行の一部として、C/C++test は (サポートされている場合) SCM クライアントを使って SCM システムから自動的にファイルの変更情報を取得します。そしてコード解析と実行されたテストの結果に基づいて特定の個人のためのタスクを生成します。

C++test 固有の実行オプションはテスト コンフィギュレーションと環境設定によって制御されま す。

テスト コンフィギュレーションについては、C/C++test のビルトイン テスト コンフィギュレーションをベースにして作成することも、GUI モードで新規に作成することもできます。ビルトイン テスト コンフィギュレーションは、そのまま使用するのではなく、ユーザー定義テスト コンフィギュレーションのためのテンプレートとして利用することを推奨します。

環境設定は C/C++test GUI から設定できます。ほとんどの環境設定は、コマンドライン インターフェイスの呼び出しにパラメーターとして渡される構成ファイルからも設定できます。設定ファイルの詳細については「ローカル設定ファイル ( オプション ファイル)」 を参照してください。GUI で設定した C/C++test の環境設定はデフォルトで適用されます。GUI の設定は、コマン ドライン モードで使用される構成ファイルの値で個別に上書きできます。そのため、ユーザーはす べてのコマンドライン実行で使用される基本的な環境設定を保持しつつ、必要に応じて特定のテスト コンフィギュレーションの特定の実行用に設定ファイルを用意できます。たとえば、テスト実行ごと に異なる情報をレポートに含める場合や、レポート名や E-mail ヘッダーなどのレポートの E-mail オプションを変更する場合などにこの方法が役立ちます。

ステップ 1: 環境設定

C/C++test の環境設定を見るには、[Parasoft] メニューの [設定] をクリックします。次の設定から開始します。

• ライセンス: ライセンス設定または License Sever 設定を指定します。
• DTP: DTP サーバー設定を指定します。
• (オプション) Team: [Team Server を有効にする] チェックボックスをオンにします。Team Server が自動検出されない場合、[サーバー情報] > [ホスト名] に Team Server の IP アドレスを入力します。C/C++test と同じマシン上で Team Server を実行 している場合は「localhost」と入力します。Team Server のデフォルト ポート (18888) をインストール時に変更したのでない限り、[ ポート番号] は変更しないでください。[接続のテスト] ボタンをクリックして接続を検証します。
• ソース管理: この設定を行うと、影響があったコードまたはテスト成果物を最後に変更した個人に対して、ツールの結果を自動的にマップすることができます。ソース管理システムを チェックし、「ソース管理リポジトリとの接続」の説明に従って SCM に適したオプションを設定します。
• スコープと作成者: 「タスクの割り当てとコード作成者の設定」にあるように、環境に適したオプションを有効にします。

• レポート: 次のオプションはデフォルトで有効であり、このオプションから開始するのが適しています。

  • 詳細な開発者レポート (タスクの詳細を含む)

  • 作成者ごとのタスクの概要(概要の表)

  • コマンドライン モードでフォーマットされたレポートを生成する

  • 抑制の詳細 (静的解析のみに適用される)

• E-mail: レポートを E-mail で送信するための設定です。C/C++test テスト マシンからアクセスできるメール サーバー上にある、既存の E-mail アカウントを指定する必要があります。

• レポート > E-mail 通知:

  • 必要に応じて [レポートを E-mail で送信する] を有効にします。この設定に関係なく、レポートは今後の参照のために常に Team Server にアップロードされます (コマンドライン インターフェイス オプションによって制御されます)。メールの配信には上記の [E-mail] の設定が使用されます。

  • マネージャー レポートには、C/C++test が生成したすべてのテスト結果が含まれます。開発者レポートには、個々の開発者のテスト結果だけが含まれます。適切なオプションを有効にし、E-mail アドレスを指定します。

ステップ 2: テスト コンフィギュレーションのカスタマイズ

「テスト コンフィギュレーションの設定」の説明に従ってユーザー定義テスト コンフィギュレーションを作成します。

ステップ 3: オプション ファイルの作成

「ローカル設定ファイル (オプション ファイル)」の説明にあるようにオプション ファイルを作成します。

ステップ 4: 現在実行中のビルド システムでコマンドライン インター フェイスをアクティブにする (たとえばバッチ スクリプト)

たとえば、コマンドは次のようになります。

• cpptestcli -solution "c:\MySolution" -resource "ProjectToTest" -config builtin://ShouldHaveRules -publish -localsettings acme_policy.settings

テストの実行

コマンドラインからテストを実行するための全般的な手順は次のとおりです。

• 適切なオプションを指定して cpptestcli ユーティリティを使用し、コマンドライン モードでテストを実行します。利用できるすべてのオプションの一覧については「コマンドライン オプション」を参照してください。主要なオプションは次のとおりです。
  • -config: テスト コンフィギュレーション。
  • -resource: テスト対象のリソース (たとえばプロジェクト、フォルダー、ファイル)。
  • -publish: DTP に結果をパブリッシュします。
  • -publishteamserver: Team Server にテスト結果をパブリッシュします。
  • -report: レポートを生成します。
  • -localsettings: Team Server/Parasoft DTP/メール レポートの詳細設定を渡します。詳細については「ローカル設定ファイル (オプション ファイル)」 を参照してください。

cli の呼び出し

cpptestcli の一般的な書式は次のとおりです。

• cpptestcli [OPTIONS]

通常、cpptestcli の呼び出しには次の書式を使用します。

コマンドライン オプション

利用できる cpptestcli のオプションは次のとおりです。

全般的なオプション

• -config %CONFIG_URL% - 実行する テスト コンフィギュレーションを %CONFIG_URL% で指定します。
プロジェクトをインストールするときを除き、このパラメーターは必須です。%CONFIG_URL% は、 URL 、ビルトイン テストコンフィギュレーションの名前、またはローカル ファイルへのパスとして解釈されます。例:
  • ファイル名:
    -config "mylocalconfig.properties"
  • URL:
    -config "http://intranet.acme.com/cpptest/team_config.properties"
  • ビルトイン コンフィギュレーション:
    -config "builtin://Demo Configuration"
-config "Demo Configuration"
  • ユーザー定義コンフィギュレーション:
    -config "user://My First Configuration"
  • チーム コンフィギュレーション:
    -config "team://Team Configuration"
-config "team://teamconfig.properties"
• -help - ヘルプ情報を表示します。テストは実行しません。
• -localsettings %LOCALSETTINGS_FILE% - オプション ファイル %LOCALSETTINGS_FILE% からグローバル設定を読み込みます。グローバル設定には、Parasoft DTP、電子メール、Team Server などの設定があります。
  オプション ファイルはプロパティ ファイルです。オプション ファイルは、レポート (レポートの送信先、レポートのラベル、メール サーバー、メール ドメインなど)、Team Server、 Parasoft DTP Server、電子メールの設定などを制御できます。オプション ファイルの作成の詳細については「ローカル設定ファイル (オプション ファイル)」を参照してください。
• -nobuild - テスト前にプロジェクトをビルドしないようにします。テストの実行前にすでにプロジェクトをビルドしている場合、このオプションを使用します。
• -fail - 違反またはセットアップの問題がレポートされた場合、ゼロ以外の終了コードを返してビルドを失敗させます (プロセスが失敗したときに返される終了コードについては「コマンド ラインの終了コード」を参照)。
  
• -publish - レポートを DTP にパブリッシュします。DTP の場所は、GUI またはオプション ファイルで指定できます(「DTPとの接続」を参照)。
• -publishteamserver - レポートを Team Server にパブリッシュします。Team Server の場所は、GUI またはオプション ファイルで指定できます (-localsettings %LOCALSETTINGS_FILE% を参照)。
• -report %REPORT_FILE% - %REPORT_FILE% で指定した XML レポートと HTML レポートを生成します。拡張子が異なる、同じ名前のレポートが、同じディレクトリに生成されます(report.format オプションを指定した場合、PDF 形式またはカスタ ム形式のレポートを生成できます)。
  次のすべてのコマンドは、 HTML レポートfilename.html および XML レポートfilename.xml を生成します。
  • -report filename.xml
  • -report filename.htm
  • -report filename.html

  ユーザーが指定したパスが拡張子 .html、.htm、.xml で終了している場合、このパスは、生成する HTML レポート ファイルへのパスとして扱われます。そうでない場合、パスはレポートを生成するディレクトリとして扱われます。
  ファイル名を明示的に指定していて、指定ディレクトリに同じ名前のファイルがすでに存在する場合、既存のファイルは上書きされます。ファイル名を明示的に指定していない場合、既存のファイルは上書きされません。新しいファイル名は repXXXX.html となります。 XXXX はランダムな数字です。
  -report を指定しない場合、レポート ファイルはデフォルトの名前 "report.xml/html" で現行ディレクトリに作成されます。

• -dtp.autoconfig %PROJECT_NAME@SERVER_NAME:port% - DTP サーバーに格納された設定を取得します (保守を容易にするために推奨します。特にローカルに格納したローカル設定ファイルがまだない場合に推奨します)。
  例:
  -dtp.autoconfig [email protected]:8080

• -encodepass <plainpassword> - 暗号化したパスワードを生成します。「Encrypted password: <encpass>」というメッセージを表示し、cli アプリケーションを終了します。
  夜間プロセスが 1) Team Server にログインし、2) 電子メールを送信する場合、このオプションを使って必須のパスワードを暗号化することができます。

• -showdetails - 詳細なテスト進行状況の情報を表示します。
  

• -disablescm - ソリューションとプロジェクトをソース管理情報から切り離します。
  ソース管理情報からソリューションとプロジェクトを切り離すことが有用な場合があります。例えば、コマンドラインモードでテストを実行している最中に、ソース管理プラグインにユーザー入力要求が達しないようにする場合などです。ソース管理情報はテストの実行後に復元されます。.sln ソリューションファイルまたは .vcproj プロジェクトファイルを変更して、ソース管理を無効化/ 有効化します。
  このオプションを使用するには、.sln および .vcproj ファイルを必ず書き込み可能にしてください。または、これらのファイルを書き込み可能にする権限があるユーザーアカウントから C/C++test を実行してください。
• -solutionConfig %SOLUTION_CONFIG_NAME% - ソリューションのビルドおよび解析に使用するソリューション構成を指定します。 Debug と Release は一般的な名前です。スイッチを省略する場合、アクティブ構成が使用されます。アクティブ構成は突然変わる可能性があるため、ソリューション構成を指定することを強く推奨します。
• -targetPlatform %TARGET_PLATFORM_NAME% - ソリューションのビルドおよび解析に使用するターゲットプラットフォームを指定します。 Any CPU とx86 は一般的な名前です。省略する場合、アクティブ構成が使用されます。アクティブ構成は突然変わる可能性があるため、ターゲットプラットフォームを指定することを強く推奨します。

• -appconsole stdout|% OUTPUT_FILE% -  C/C++test のコンソール出力を標準出力または %OUTPUT_FILE% ファイルにリダイレクトします。
  例:
  -appconsole stdout (標準出力にリダイレクトされるコンソール)
  -appconsole console.out (console.out file ファイルにリダイレクトされるコンソール)

• -list-compilers - 有効なコンパイラの種類の値を出力します。  このオプションは -solution とともに使用する必要があります。

• -list-configs - 有効なテスト コンフィギュレーションの値を出力します。 このオプションは -solution とともに使用する必要があります。

• -bdf - 入力スコープを収集するための既存のビルド データ ファイル (.bdf) または別のプロジェクト定義ファイルへのパスを指定します。ビルド データ ファイルの作成については「cpptestscan または cpptesttrace を使ってビルド データ ファイルを作成する」を参照してください。このオプションは、静的解析を実行する場合、CMake ビルド システムによって生成されるJ SON フォーマットのファイルもサポートします。単体テスト実行での -bdf オプションを使用した JSON ファイルの指定は、現在サポートされていません。  

• -include %PATTERN%, -exclude %PATTERN% - テストに含める/除外するファイルを指定します。
  このオプションの後に、ファイル名またはパスを指定する必要があります。
  ファイル名の指定にはワイルドカード * および? を使用できます。1 つ以上のパス名のセグメントを指定するには ** を使用します。シンタックスのパターンは Ant ファイル セットの指定に似ています。
  例:
  -include **/Bank.cpp (Bank.cpp ファイルをテストする)

  -include **/ATM/Bank/*.cpp (ATM/Bank フォルダー中のすべての .cpp ファイルをテストする)

  -include c:/ATM/Bank/Bank.cpp (c:/ATM/Bank/Bank.cpp ファイルだけをテストする)

  -exclude **/internal/** (パス中に "internal" というフォルダーがあるクラスをテストから除外する)

  -exclude **/*Test.cpp (Test.cpp で名前が終わるファイルをテストから除外する)

  さらに、拡張子が.lst のファイルを指定した場合、このファイルはパターン リスト ファイルとして扱われ、ファイル中の各行が1 つのパターンとして扱われます。
  たとえば、次のようにオプションを設定し、-include c:/include.lstinclude.lst ファイルの内容が次のとおりであるものとします。
  **/Bank.cpp

  **/ATM/Bank/*.cpp

  c:/ATM/Bank/Bank.cpp

  この設定は、次のオプション設定と同じことになります。
  -include **/Bank.cpp -include **/ATM/Bank/*.cpp

  -include c:/ATM/Bank/Bank.cpp"

Visual Studio IDE でプロジェクトをテストするためのオプション

ローカル設定ファイル (オプション ファイル)

ローカル設定ファイルをコマンドラインで渡して、レポート、タスクの割り当て、ライセンスといったオプションを制御することができます。ローカル設定ファイルを使用すると、以下のことが可能です。

• プロジェクトごとに異なる設定を使用することができます。
• 必要に応じてチーム全体の設定を拡張したり上書きすることができます (例えばローカルパスに関連する設定など)。
• GUI を開かずに設定を変更できます。

プロジェクトごとにオプション ファイルを作成し、-localsettings オプションを使ってどのファイルを使用するかを指定できます。

ローカル設定ファイルの詳細および利用可能なオプションの一覧は、「ローカル設定の指定」を参照してください。