カバレッジの計測

カバレッジログ計測手順

dotTESTインストールマシンで実施

テスト対象アプリケーションがあるマシンから【前提】にも記載されている以下のファイル群を入手しておく必要があります。

Coverage フォルダ
- カバレッジ計測後のカバレッジログなどが含まれるフォルダ
ソリューション一式
- テストを実行した際に使用したものと同じソリューション一式

ソリューション一式をdotTESTインストールマシンに配置

ソリューション一式をdotTESTがインストールされているマシンに配置します。ソリューションはdotTESTインストールマシン上でビルド可能である必要があります。
可能であれば、カバレッジ取得時と同じパスに配置します。難しい場合、カバレッジログの内容を、ソリューションを配置したフルパスに書き換える必要があります。

カバレッジ取得時と同じパスに配置出来なかった場合、ソリューションに含まれるexeなど、ビルドの成果物は削除します。
これは、pdbファイルの情報を書き換えるためのものです。ビルドはdotTESTでカバレッジ解析時に実行され、新しい成果物が生成されます。

※ こちらから下の手順は、dotTEST Engineエディションのライセンスをお持ちの場合の手順です。
　 dotTEST Desktopエディションのライセンスをお持ちの場合はこちら（dotTEST Desktopエディションのライセンスをお持ちの場合）のページを参考に実施してください。

CoverageフォルダをdotTESTインストールマシンに配置

可能であれば、カバレッジ取得時と同じパスにCoverageフォルダを配置します。
難しい場合、設定ファイルの内容を書き換える必要があります。

「importCoverage.bat」の修正
以下の様にバッチ作成時の情報が記述されているため、配置したCoverageフォルダや、ソリューションフォルダに合わせてパスを修正します。

pushd "C:\Users\xxxxxxxxx\Documents\Parasoft\dotTEST\Coverage"
"C:\Program Files\Parasoft\dotTEST\2020.2\dottestcli.exe" 
-settings "C:\Users\xxxxxxxxx\Documents\Parasoft\dotTEST\Coverage\coverage.settings" 
-config "builtin://Calculate Application Coverage" 
-report "C:\Users\xxxxxxxxx\Documents\Parasoft\dotTEST\Coverage\reports" 
-solution "C:\Users\xxxxxxxxx\project\sample_project\MovieTicket\MovieTicket.sln"
popd

静的カバレッジファイルのパスを修正

カバレッジログの収集を行った時のソリューションのパスとdotTESTインストールマシンに配置した際のソリューションのパスが違っている場合、静的カバレッジファイルのパスを修正する必要があります。
静的カバレッジファイルとは、Coverage\CoverageLogsフォルダ直下にあるCoverageMapで始まる.logファイルです。

静的カバレッジファイルには、以下のように、カバレッジログ収集時のソースコードパスが含まれているため、dotTESTインストールマシンに配置したソリューションに合わせてパスを変更します。
例えば、下記の場合、「C:\Users\covuser\project\sample_project」までのパスを配置したソリューションに合わせて変更します。

カバレッジの計測

Visual Studio 上で結果を確認する場合
前段の準備が完了したら、importCoverage.batを実行することでカバレッジが計測されます。
importCoverage.bat の実行が完了すると、reportsディレクトリが作成され、coverage.xmlなどのレポートファイルが生成されます。

ソリューションファイル（StackMachineExample.sln）を開き、コンテキストメニューの[Parasoft] – [ビューの表示] – [カバレッジ]を選択します。
表示されたカバレッジのビューから ▼ – [インポート] – [ローカルファイルまたは URL...]を選択します。
overage.xml を絶対パスで指定します。
インポートが正常終了すると「カバレッジのインポートが終了しました。」と表示されます。
計測したアプリケーションカバレッジのデータがVisual Studio上で閲覧できます。

Parasoft DTP に結果を Publish （登録）して Web上で確認する場合

Parasoft DTPへ結果をPublishするためにはdottestcli.propertiesに以下の設定を行います。

# === DTP SERVER SETTINGS === 
dtp.server= [DTPサーバ] 
dtp.port= [ポート番号] 
dtp.user= [ユーザー] 
dtp.password= [パスワード] 
# === REPORTING === 
report.dtp.publish=true

importCoverage.batの実行時にPublishが実行されます。

Parasoft DTP での結果の確認方法についてはこちら（Parasoft DTPを用いた運用の例）のページを参考に実施してください。