TeamCity

Measure your test quality and your team's progress by taking advantage of NCover's advanced code coverage features within TeamCity 5.

Requirements

15 minutes, installation of Team City 5 (TC5), a .NET build framework (e.g., NAnt or MSBuild).
Note that this document provides only a setup tutorial for NCover with TC5, not a comprehensive setup for TC5. A full TC5 configuration tutorial can be found on the TC5 website. If you are using TeamCity 4, find the NCover tutorial here.
This document follows the Project Setup > Build Template Setup flow in TC5. Users should keep in mind that automatic display of NCover reports in TC5 only works when using TeamCity's built-in NUnit test runner. If you're using a different test framework, you should see the section on setting up NCover as a task of your build script rather than TC5 in order to import and view your coverage results.

Basic Setup

Install TeamCity 5 on the machine (instructions here). TeamCity's configurations differ slightly based on the build runner and unit testing framework used. From the runner setup window, select the build runner: NAnt or MSBuild. (For .NET builds, TC5 currently supports MSBuild and NAnt. See docs.ncover.com for more information about setting up other build runners.)

NAnt Configuration

Setting the Runner
  1. Set the build runner to NAnt and provide a build file path.
    teamcity_nant.png
  2. Set the .NET coverage tool to NCover 3.x.
    teamcity_netcvgtool.png
  3. Set the. NET runtime fields to the values appropriate for your configuration.
    teamcity_netruntime.png
  4. Supply the path to the NCover 3 NCover.Console.exe executable. The %system.ncover.v3.x86.path% (or %system.ncover.v3.x64.path% when testing 64-bit applications) refers to the auto-detected path for NCover 3 on the build agent. Alternatively, you can provide the specific path, typically "C:\Program Files\NCover\NCover.Console.exe" (or "C:\Program Files (x86)\NCover\NCover.Console.exe for 32-bit NCover on a 64-bit system).
    teamcity_ncpath.png
  5. Supply any NCover.Console and NCover.Reporting arguments. Click the highlighted text that first appears to reveal a default argument demonstrating syntax. For a complete list of NCover.Console arguments, refer to the NCover.Console documentation. For NCover.Reporting arguments, see the NCover.Reporting documentation.
    teamcity_ncargs.png
  6. Click "Save" at the bottom of the page. Settings will appear when the window refreshes (see image below). Your project is configured to collect coverage.
    teamcity_nant_full.png

MSBuild Configuration

Setting the Runner
  1. Set the build runner option to MSBuild and provide a build file path.
    teamcity_msbuild.png
  2. Set the MSBuild version. NCover supports all the. NET frameworks, including 4.0. Mono is not currently supported by NCover.
    teamcity_msbuild_netver.png

    Optional: Enter the name of the build target you would like to use. The default build target for your build will be executed if none is specified.
  3. Based on the. NET runtime version you're using, select the appropriate MSBuild tools version & run platform (x86 or x64).
    teamcity_msbuild_runtime.png
  4. Set the .NET coverage tool to NCover 3. x.
    teamcity_netcvgtool.png
  5. Set the .NET Runtime fields to the values appropriate for your configuration.
    teamcity_msbuild_netframe.png
  6. Supply the path to the NCover 3 NCover.Console.exe executable. The %system. ncover. v3. x86. path% (or %system. ncover. v3. x64. path% when testing 64-bit applications) variable refers to the auto-detected path for NCover 3 on the build agent. Alternatively, you can provide the full path, typically "C: \Program Files\NCover\NCover.Console.exe" ("C: \Program Files (x86) \NCover\NCover.Console.exe" for 32-bit NCover on 64-bit systems).
    teamcity_ncpath.png
  7. Supply any NCover.Console and NCover.Reporting arguments. Click the highlighted text that first appears to reveal a default argument demonstrating syntax. For a complete list of NCover.Console arguments, refer to the NCover.Console documentation. For NCover.Reporting arguments, see the NCover.Reporting documentation.
    teamcity_ncargs.png
    Note: The NCover arguments should not include a call to run NCover (e. g., "[…path to NCover…]\NCover. console. exe"). TeamCity automatically provides that command when the NCover3.x selection is made for .NET coverage.
  8. Click "Save" at the bottom of the page. Settings will appear when the window refreshes (see image below). Your project is configured to collect coverage.
    teamcity_msbuild_full.png

Manualy Configure Coverage Display

When using TeamCity's built-in NUnit runner for your test framework, displaying coverage is already handled through the TeamCity GUI setup. If you are using a different test configuration, however, you must run NCover.Console.exe from a build script using TeamCity's service messages to pass your coverage file to TeamCity. (Service messages are output calls from your build script and of a form unique to that build agent. See more here.) TC5 will then invoke NCover.Reporting.exe (also through service messages) and publish your coverage to their interface.

Examples

NAnt Script 
    
    <!--Important! Don't forget to include the <loadtasks…/> in your script. Leaving it out will throw an error because NAnt will not be able to interpret the call to NCover. /-->
    
    <loadtasks assembly="C:\Program Files\NCover\Build Task Plugins\NCover.NAntTasks.dll" />
    
    <target name="coverage" description="Generate code coverage using NCover">
        <ncover program="C:\Program Files (x86)\NCover\NCover.Console.exe"
        coverageFile="PATH FOR YOUR COVERAGE XML FILE"
        testRunnerExe="PATH TO TESTED APPLICATION"
        workingDirectory="PATH TO WORKING DIRECTORY"
        serviceTimeout="0"
        onlyAssembliesWithSource="true"
        projectName="[Your Project Name]"	/>
    
    <echo message="##teamcity[dotNetCoverage ncover3_home='PATH TO YOUR NCOVER DIRECTORY']" />
        
    <echo message="##teamcity[dotNetCoverage ncover3_reporter_args='//or FullCoverageReport:Html:{teamcity.report.path}']" />
    
    <echo message="##teamcity[importData type='dotNetCoverage' tool='ncover3' path='PATH TO YOUR COVERAGE XML FILE']" />
    
    </target>

MSBuild Script 
    
    <?xml version="1.0" encoding="utf-8"?>
    
    <Project DefaultTargets="Coverage" xmlns="http://schemas.microsoft.com/developer/msbuild/2003" >
    
    <!--Important! Don't forget to include the <UsingTasks…/> in your script. Leaving it out will throw an error because MSBuild will not be able to interpret the call to NCover. /-->
    
    <UsingTask TaskName="NCover.MSBuildTasks.NCover" AssemblyFile="C:\Program Files\NCover\Build Task Plugins\NCover.MSBuildTasks.dll" /> 
    
    <UsingTask TaskName="NCover.MSBuildTasks.NCoverReporting" AssemblyFile="C:\Program Files\NCover\Build Task Plugins\NCover.MSBuildTasks.dll" /> 
    
    <Target Name="Coverage">
        <NCover ToolPath="C:\Program Files\NCover\" TestRunnerExe="$(NUnitPath)\nunit-console.exe" TestRunnerArgs="TestAssembly1.dll TestRunner2.dll" CoverageFile="Coverage.xml"/>
    
        <Message Text="##teamcity[dotNetCoverage ncover3_home='PATH TO YOUR NCOVER DIRECTORY']" />
        
        <Message Text="##teamcity[dotNetCoverage ncover3_reporter_args='//or FullCoverageReport:Html:{teamcity.report.path}']" />
    
        <Message Text="##teamcity[importData type='dotNetCoverage' tool='ncover3' path='PATH TO YOUR COVERAGE XML FILE']" />
    
    </Target>
    
    </Project>
When you run your build using service messages, TeamCity should display your coverage results in the "Overview" tab. You can see coverage details in the "Coverage" tab.