...
カバレッジログ計測手順
| Info |
|---|
dotTESTインストールマシンで実施 |
テスト対象アプリケーションがあるマシンから【前提】に記載されている以下のファイル群を入手しておく必要があります。にも記載されている以下のファイル群を入手しておく必要があります。
Coverage フォルダ
カバレッジ計測後のカバレッジログなどが含まれるフォルダ
Coverage フォルダの作成先ディレクトリは、coverage.exe を実行した際に作成される dottest.Hooks.deps.json に記載されています。
ソリューション一式
テストを実行した際に使用したものと同じソリューション一式
...
ソリューション一式をdotTESTインストールマシンに配置
ソリューション一式をdotTESTがインストールされているマシンに配置します。ソリューションはdotTESTインストールマシン上でビルド可能である必要があります。
可能であれば、カバレッジ取得時と同じパスに配置します。難しい場合、カバレッジログの内容を、ソリューションを配置したフルパスに書き換える必要があります。
カバレッジ取得時と同じパスに配置出来なかった場合、ソリューションに含まれるexeなど、ビルドの成果物は削除します。
これは、pdbファイルの情報を書き換えるためのものです。ビルドはdotTESTでカバレッジ解析時に実行され、新しい成果物が生成されます。
CoverageフォルダーをdotTESTインストールマシンに配置
任意のパスにCoverageフォルダーを配置します。※ こちらから下の手順は、dotTEST Engineエディションのライセンスをお持ちの場合の手順です。
dotTEST Desktopエディションのライセンスをお持ちの場合はこちら（dotTEST Desktopエディションのライセンスをお持ちの場合）のページを参考に実施してください。
CoverageフォルダをdotTESTインストールマシンに配置
可能であれば、カバレッジ取得時と同じパスにCoverageフォルダを配置します。
難しい場合、設定ファイルの内容を書き換える必要があります。
「importCoverage.bat」の修正
以下の様にバッチ作成時の情報が記述されているため、配置したCoverageフォルダーや、ソリューションフォルダーに合わせてパスを修正します。以下の様にバッチ作成時の情報が記述されているため、配置したCoverageフォルダや、ソリューションフォルダに合わせてパスを修正します。Code Block 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で始まるCoverageLogsフォルダ直下にあるCoverageMapで始まる.logファイルです。
...
静的カバレッジファイルには、以下のように、カバレッジログ収集時のソースコードパスが含まれているため、dotTESTインストールマシンに配置したソリューションに合わせてパスを変更します。
例えば、下記の場合、「C:\Users\covuser\project￥sampleproject\sample_project」までのパスを配置したソリューションに合わせて変更します。
...
カバレッジの計測
※ こちらの手順は、dotTEST Engineエディションのライセンスをお持ちの場合の手順です。
dotTEST Desktopエディションのライセンスをお持ちの場合はこちらのページを参考に実施してください。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に以下の設定を行います。
| Code Block |
|---|
# === DTP SERVER SETTINGS ===
dtp.server= [DTPサーバ]
dtp.port= [ポート番号]
dtp.user= [ユーザー]
dtp.password= [パスワード]
# === REPORTING ===
report.dtp.publish=true |
importCoverage.batの実行時にPublishが実行されます。
Parasoft DTP での結果の確認方法についてはこちら（Parasoft DTPを用いた運用の例）のページを参考に実施してください。