Microsoft.CodeCoverage.Console tool
Microsoft.CodeCoverage.Console is a command-line tool. You can use it to collect code coverage for C++ and C# code. It supports also merging and converting code coverage reports. This tool can be used to collect code coverage in non-test scenarios (for example, for a simple console application).
Microsoft.CodeCoverage.Console is available in Visual Studio 2022 17.3 under the folder Common7\IDE\Extensions\Microsoft\CodeCoverage.Console
. You can use it in a Developer Command Prompt and a Developer PowerShell:
Note
The tool is available only with Visual Studio Enterprise. For .NET code coverage, you can alternatively use the command-line tool, dotnet-coverage.
C:\Program Files\Microsoft Visual Studio\2022\Enterprise> Microsoft.CodeCoverage.Console --help
Description:
Dynamic code coverage tools.
Usage:
codecoverage [command] [options]
Options:
--version Show version information
-?, -h, --help Show help and usage information
Commands:
collect <command> <args> Collect code coverage from inner process and subprocesses.
connect <session> <command> <args> Connects to an existing code coverage session and collects code coverage from
inner process and subprocesses.
merge <files> Merge coverage reports
shutdown <session> Close existing code coverage collection.
snapshot <session> Creates coverage file for existing code coverage collection.
instrument <input-file> Instruments native binary.
The Microsoft.CodeCoverage.Console tool is extension to the dotnet-coverage dotnet tool. The documentation for collect, connect, shutdown, merge, and snapshot commands can be found here.
Microsoft.CodeCoverage.Console supports additional security features to enable collecting ASP.NET code coverage data from IIS. Additionally, the Microsoft.CodeCoverage.Console tool supports collecting code coverage for C++ code. The instrument
command is specific to these scenarios.
The instrument command is used to instrument native or managed binary on disk.
Microsoft.CodeCoverage.Console instrument
[-s|--settings <settings>] [-id|--session-id <session-id>]
[-o|--output <output>] [-l|--log-file <log-file>]
[-ll|--log-level <log-level>] [-?|-h|--help]
<input-file>
<input-file>
The input binary.
-s|--settings <settings>
Sets the path to the XML code coverage settings.
-id|--session-id <session-id>
Specifies the code coverage session ID. If not provided, the tool generates a random GUID.
-o|--output <output>
Sets the path to output file binary. If not provided, instrumentation will be performed in-place.
-l|--log-file <log-file>
Sets the log file path. When you provide a directory (with a path separator at the end), a new log file is generated for each process under analysis.
-ll|--log-level <log-level>
Sets the log level. Supported values:
Error
,Info
, andVerbose
.
The Microsoft.CodeCoverage.Console tool can be used to collect code coverage for C++ using static instrumentation. There are three different methods available that you can use. To demonstrate, let's assume we have a simple C++ console application (linked with the option /PROFILE):
D:\ConsoleApplication\x64\Debug> .\ConsoleApplication.exe
Hello World!
If you don't want to use the instrument
command, you can instead use a configuration file to specify the files to instrument, as follows:
<ModulePaths>
<IncludeDirectories>
<Directory>D:\ConsoleApplication\x64\Debug</Directory>
</IncludeDirectories>
</ModulePaths>
Then, collect code coverage as follows:
D:\ConsoleApplication\x64\Debug>Microsoft.CodeCoverage.Console collect --settings coverage.config .\ConsoleApplication.exe
SessionId: 85d9d49e-38a7-43a4-81ff-9e12f0e6b04b
Hello World!
Code coverage results: output.coverage.
Before collecting code coverage data, first instrument the binary as follows:
D:\ConsoleApplication\x64\Debug>Microsoft.CodeCoverage.Console instrument ConsoleApplication.exe
Input file successfully instrumented.
Then, collect code coverage as follows:
D:\ConsoleApplication\x64\Debug>Microsoft.CodeCoverage.Console collect .\ConsoleApplication.exe
SessionId: e85e657f-9ff3-42a0-88d7-2349598a1ecd
Hello World!
Code coverage results: output.coverage.
Using this method, you can separate code coverage collection from running your application. First, instrument your binary as follows:
D:\ConsoleApplication\x64\Debug>Microsoft.CodeCoverage.Console instrument --session-id 73c34ce5-501c-4369-a4cb-04d31427d1a4 ConsoleApplication.exe
Input file successfully instrumented.
Note
Session ID needs to be used in this scenario to make sure that the application can connect and provide data to external collector.
In the second step, you need to start the code coverage collector as follows:
D:\ConsoleApplication\x64\Debug>Microsoft.CodeCoverage.Console collect --session-id 73c34ce5-501c-4369-a4cb-04d31427d1a4 --server-mode
SessionId: 73c34ce5-501c-4369-a4cb-04d31427d1a4
Then, start the application as follows:
D:\ConsoleApplication\x64\Debug>.\ConsoleApplication.exe
Hello World!
Note
Instrumented native binary contains a reference to static_covrun64.dll
. Make sure that this file is next to the instrumented binary or the directory where static_covrun64.dll
is located is listed in the Path
environment variable. The collect
and connect
commands are adding proper directories to Path
automatically.
Finally, close the collector as follows:
D:\ConsoleApplication\x64\Debug>Microsoft.CodeCoverage.Console shutdown 73c34ce5-501c-4369-a4cb-04d31427d1a4