C/C++testの静的解析チュートリアルにてコマンドライン上から解析の実施を行いました。チュートリアルで実施した方法では、GUI上で既にプロジェクトをインポート済みであり、テストコンフィギュレーションやライセンス設定といったGUI上の設定を使用した解析方法になります。静的解析チュートリアルにて、コマンドライン上から解析の実施を行いました。その方法では、GUI上で既にプロジェクトをインポート済みであり、テストコンフィギュレーションやライセンス設定といったGUI上で設定した設定を用いる解析方法を説明しています。
しかし、C/C++testを運用する中でGitHubやAzure Dev OpsなどCItestを運用する中でCI/CDの自動実行環境に組み込めるようGUIの設定を使用せず、CUIのみで完結させたい場合もあります。CDの自動実行環境など、GUIを使用せず、コマンドラインのみで設定を完結させたい場面も存在します。
そういった場合、テストコンフィギュレーションやライセンス設定などの情報を解析時に適用することができるそういった場合、"設定ファイル"を使用することで、コマンドライン上でGUIと同等の設定を適用して解析を行うことが可能です。
本ページではコマンドライン上の操作のみで解析を実施する方法をご紹介いたします。
解析を実施するための流れは以下の通りになります。
| 子ページ (子表示) | ||
|---|---|---|
|
BDFの作成
ビルド・データ・ファイル（BDF）の作成方法はチュートリアルで実施した方法と差異はありません。
詳しくはxxxをご参照ください。
BDFのインポート
コマンドライン上からBDFをインポートする方法は、解析実行時のコマンドを使用することで、GUIと同等の設定をコマンドライン上で適用することができます。
本ページでは、設定ファイルを用いてコマンドライン上の操作のみで解析を実施する方法をご紹介いたします。
| 目次 | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BDFの作成
ビルドデータファイル（BDF）の作成方法はチュートリアルで実施した方法と差異はありません。
実際のプロジェクトを対象としたBDF作成について、詳しくは[ ビルドデータファイルを使用したプロジェクトの作成 ]をご参照ください。
プロジェクトのインポート
コマンドライン上からプロジェクトをインポートする方法は、解析実行時のコマンド(cpptestcli)に"-bdf"オプションを付与することでインポートが可能です。オプションを付与することで、プロジェクトをインポートすることができます。
| コード ブロック |
|---|
例） cpptestcli -data "<C/C++test ワークスペース>" -resource "テスト対象のリソース" ... -bdf <BDFのパス> |
静的解析の実施
設定ファイルを使用した静的解析は、解析実行時のコマンドに"-settings"オプションを付与することで設定ファイルの情報を適用することができます。オプションを付与することで、設定ファイルの情報を適用することができます。
| コード ブロック |
|---|
例） cpptestcli -data "<C/C++test ワークスペース>" -resource "テスト対象のリソース"<テスト対象のリソース> ... -bdf <BDFのパス> -settings <設定ファイルのパス> |
※cpptestcliに付けるオプションの詳細は「コマンドライン インターフェイスからのテスト」に記載されております
設定ファイルの作成方法
上述した設定ファイルの作成方法は次の２つの方法があります。上述した設定ファイルの作成方法は次の２つがあります。
ユーザが手動で設定ファイルを作成する手動で設定ファイルを作成する
GUIの設定をエクスポートする
...
手動で設定ファイルを作成する
ユーザ自身が設定ファイルを用意してファイル内に必要な設定を記載します。（ファイルの名前や保存場所に制限はございません）
設定ファイル内に記載する情報は、ユーザーズガイドの[ 設定ファイルでの指定 ]に記載されています。
GUIの設定をエクスポートする
GUI上の設定を設定ファイルとしてエクスポートさせることが可能です。この方法の場合、[ユーザが手動で設定ファイルを作成する]とは異なり、設定ファイルを１から作成する必要はございません。また、GUI上で設定した内容と同等の設定を適用することが可能になるため、基本的にGUIの設定をエクスポートする方法を推奨しております。
設定ファイルのエクスポート方法は、以下の手順でエクスポートが可能です。
１．GUI上の設定を設定ファイルとしてエクスポートさせることが可能です。この方法の場合、設定ファイルを１から作成する必要はございません。
また、GUI上で設定した内容と同等の設定を別環境・別プロジェクトにも適用することが可能になるため、基本的にGUIの設定をエクスポートする方法を推奨しております。
設定ファイルのエクスポート方法は、以下の手順でエクスポート可能です。
１．メニューから[Parasoft] メニューの > [設定] をクリックしてをクリックします
２．左側のリストから ２．左側のツリーから [Parasoft] を選択します。
３．パネルの右側で を選択します
３．[設定の構成]内にある [共有] リンクをクリックします。リンクをクリックします
４．ダイアログが開いたら、ファイルにエクスポートする設定を指定します。４．ダイアログが開いたら、ファイルにエクスポートする設定を指定します
５．[参照] ボタンをクリックし、設定を保存するファイルを指定します。ボタンをクリックし、設定を保存するファイルを指定します
６．[OK] をクリックします。
解析の実行方法
コマンドライン上で解析を実行するためには、C/C++test インストールパッケージ内に存在する”cpptestcli”の実行ファイルを使用し、ワークスペースやテストコンフィギュレーションの指定などといったオプションを付与することで解析を実施することが可能です。実行方法の詳細につきましては、ユーザーズガイドの[コマンドライン インターフェイスからのテスト]に設定方法やオプションが記載されております。
GUIの設定を使用せずにコマンドライン上の設定のみで解析を行う場合、”cpptestcli”実行時のオプションにプロジェクトのインポートやライセンス情報などを格納した”設定ファイル”を付与する必要があります。
プロジェクトのインポート、設定ファイルの設定方法につきましては、下記の通りになります。
プロジェクトのインポート
コマンドライン上の操作のみで解析を実施する場合、解析対象プロジェクトをC/C++testが認識できるようプロジェクトのインポートを行う必要があります。
プロジェクトのインポートの例といたしまして、"cpptestcli"実行時のオプションに"-bdf <BDFのパス>"を付与することで、インポートが可能になります。
| コード ブロック |
|---|
例）cpptestcli -data "<C/C++test ワークスペース>" -resource "テスト対象のリソース" ... -bdf <BDFのパス> |
※BDFの作成は[ビルドデータファイルを使用したプロジェクトの作成]をご参考ください
設定ファイル
C/C++testのライセンスやテストコンフィギュレーション、レポート生成の詳細な指定については、"設定ファイル"を使用することで解析時に適用させることが可能です。
| 情報 |
|---|
設定ファイルとは 設定ファイルをコマンドラインに渡すことで、レポート、タスクの割り当て、ライセンスといったオプションを制御することができます。
|
設定ファイルは"cpptestcli"実行時のオプションに"-settings <設定ファイルのパス>"を付与することで、ファイル内に記載された情報を適用させることが可能になります。
| コード ブロック |
|---|
例）cpptestcli -data "<C/C++test ワークスペース>" -resource "テスト対象のリソース" ... -settings <設定ファイルのパス> |
設定ファイルの作成方法
設定ファイルの作成方法は、次の２つの方法があります。
１．ユーザが手動で設定ファイルを作成する
２．GUIの設定をエクスポートする
ユーザが手動で設定ファイルを作成する
ユーザ自身が設定ファイルを用意してファイル内に必要な設定を記載します。（ファイルの名前や保存場所に制限はございません）
設定ファイル内に記載する情報は、ユーザーズガイドの[設定ファイルでの指定]に記載されています。
GUIの設定をエクスポートする
GUI上の設定を設定ファイルとしてエクスポートさせることが可能です。この方法の場合、[ユーザが手動で設定ファイルを作成する]とは異なり、設定ファイルを１から作成する必要はございません。また、GUI上で設定した内容と同等の設定を適用することが可能になるため、基本的にGUIの設定をエクスポートする方法を推奨しております。
設定ファイルのエクスポート方法は、[設定ファイルの指定と保存]をご参照ください。をクリックします