TeamCity.VSTest.TestAdapter: A C# repository from JetBrains

Test Adapter for

Provides the TeamCity integration with test frameworks via the Visual Studio Test Platform or VSTest IDE tools.

It is important to note that the above demo works from the command line when the environment variable TEAMCITY_VERSION exists with any value during dotnet commands. TeamCity automatically specifies this environment variable by the current TeamCity version for each build step.

Supported platforms:

Visual Studio Test Platform
VSTest Console version 12+

Visual Studio Test Platform

Presently, Visual Studio has an open and extensible test platform with tests written using various test frameworks and run using a variety of adapters. The Test Platform, from its vantage, resolves the lifecycle of the test into a series of stages – two of which are writing and running the test – with the goal of providing extensibility at each stage.

For each test project:

Add a NuGet reference to the Visual Studio Test Platform.
```
dotnet add package Microsoft.NET.Test.Sdk
```

Add NuGet references to NuGet packages of the selected test framework and coresponding test adapter which supports Visual Studio Test Platform. For example:

MSTest Framework and Adapter

dotnet add package MSTest.TestFramework   
dotnet add package MSTest.TestAdapter

XUnit Framework and Adapter

dotnet add package xunit   
dotnet add package xunit.runner.visualstudio

NUnit Framework and Adapter

dotnet add package NUnit   
dotnet add package NUnit3TestAdapter

DevTeam Framework and Adapter

dotnet add package DevTeam.TestFramework   
dotnet add package DevTeam.TestAdapter

or others.

Alternatively to two steps above, you could create the a test project from the command line using the specified template:

dotnet new mstest

dotnet new xunit

To support the TeamCity integration add a NuGet reference to the TeamCity Test Adapter to turn on the TeamCity integration.
```
dotnet add package TeamCity.VSTest.TestAdapter
```

Thus, the final project file could look like the following:

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>    
    <TargetFrameworks>net45;netcoreapp1.0;netcoreapp2.0</TargetFrameworks>    
  </PropertyGroup>

  <ItemGroup>
    <PackageReference Include="Microsoft.NET.Test.Sdk" Version="15.8.0" />
    <PackageReference Include="MSTest.TestFramework" Version="1.3.2" />
    <PackageReference Include="MSTest.TestAdapter" Version="1.3.2" />
    <PackageReference Include="TeamCity.VSTest.TestAdapter" Version="1.0.15" />    
  </ItemGroup>  
</Project>

VSTest Console

To support the TeamCity integration, add a NuGet reference to the TeamCity Test Adapter
To run tests from the command line, use additional command line arguments: /TestAdapterPath:., /Logger:teamcity
- The first argument points to the path where the runner can find the assembly of the TeamCity logger (the directory of the testing aseembly).
- The second argument points to the TeamCity service messages logger.

For example:

"C:\Program Files (x86)\Microsoft Visual Studio 14.0\Common7\IDE\CommonExtensions\Microsoft\TestWindow\vstest.console.exe" dotNet.XUnit.Tests.dll /Logger:teamcity /TestAdapterPath:.

VSTest extensions

Download the custom logger
Extract the contents of the downloaded archive on the agent machine:

Visual Studio	Content directory	Target directory
2019	vstest15	PROGRAM_FILES(x86)\Microsoft Visual Studio\2019<Edition>\Common7\IDE\Extensions\TestPlatform\Extensions
2017 update 5 onwards	vstest15	PROGRAM_FILES(x86)\Microsoft Visual Studio\2017<Edition>\Common7\IDE\Extensions\TestPlatform\Extensions
2017 till update 4	vstest15	PROGRAM_FILES(x86)\Microsoft Visual Studio\2017<Edition>\Common7\IDE\CommonExtensions\Microsoft\TestWindow\Extensions
2015	vstest14	PROGRAM_FILES\Microsoft Visual Studio 14.0\Common7\IDE\CommonExtensions\Microsoft\TestWindow\Extensions
2013	vstest12	PROGRAM_FILES\Microsoft Visual Studio 12.0\Common7\IDE\CommonExtensions\Microsoft\TestWindow\Extensions
2012	vstest12	PROGRAM_FILES\Microsoft Visual Studio 11.0\Common7\IDE\CommonExtensions\Microsoft\TestWindow\Extensions

Check that the custom logger was installed correctly by executing vstest.console.exe /ListLoggers in the console on the agent machine. For instance:

C:\Program Files (x86)\Microsoft Visual Studio\2019\Professional\Common7\IDE\Extensions\TestPlatform\vstest.console.exe /ListLoggers

If the logger was installed correctly, you will see the logger with FriendlyName TeamCity listed:

TeamCity.VSTest.TestLogger.TeamCityTestLogger
   Uri: logger://TeamCity   
   FriendlyName: TeamCity

See more details in the Wiki.

See the article for details on how to create tests using the Visual Studio Test Platform.

Docker Container Support

To run tests from within a Docker container that is hosted on a machine running the TeamCity agent, the container must have a TEAMCITY_PROJECT_NAME or TEAMCITY_VERSION environment variable set. Example:

docker run --rm -v $PWD:/app -w /app -e TEAMCITY_VERSION microsoft/dotnet:2.1-sdk dotnet test

Known issues

Tests are not reported for .NET Core xunit test projects when the logging verbosity level is minimal or quiet because of issue, so try use the verbosity level normal or more detailed, for instance:
- dotnet test --verbosity normal
- dotnet vstest mytests.dll /logger:console;verbosity=normal

JetBrains/TeamCity.VSTest.TestAdapter