We are excited to announce the new MSTest SDK built on top of the MSBuild Project SDK system. It is designed to give you a better experience for testing with MSTest by making project configuration easier through sensible defaults and flexible options.<\/p>\n
This new experience was built on top of the recently introduced MSTest runner (check out the announcement post<\/a>) to further simplify your experience. This new runner, a lightweight, reliable, and performant way to run MSTest tests, is shipped as dependency of Getting started using the new MSTest SDK is easy. Just create a MSTest project (or update an existing MSTest project) and replace the content of the Note that you can use any target framework supported by MSTest (i.e. This new SDK offers many advantages for you and your test projects, such as: <\/p>\n When using the MSTest SDK, you are aligning with the patterns that are provided by the main types of applications such as ASP.NET Core, Razor, Windows Desktop. It will use the default suggestions that the MSTest team makes for your test projects.<\/p>\n For example, we introduced some MSTest static code analyzers with v3.2 but these analyzers are defined in a new package that is not available by default so you would have to manually add this package to your test projects. Instead, by using MSTest SDK, you would simply bump the version and get all the new defaults.<\/p>\n We want to call out that we are following semantic versioning (see this article about semantic versioning<\/a>) principles closely when choosing the defaults and updating them between versions, so you have the guarantee of understandable and easy updates.<\/p>\n In addition to MSTest runner<\/a>, we are also shipping a set of extensions that you can install as NuGet packages to enhance your testing experience. To help you select the right defaults, the right extensions and to make sure you have easy update and alignments between the extensions, we are introducing a new concept of “profiles”. We are currently providing the following 3 profiles: The default profile contains:<\/p>\n Starting from any profile, you can then manually opt-in or opt-out any additional extension adding some additional properties to your project that would follow the pattern You can refer to our MSTest SDK documentation<\/a> to get more information about these profiles and their defaults.<\/p>\n MSTest is the first .NET Test Framework and runner to support running tests in Native AOT mode. When using MSTest SDK, we will automatically detect if you are publishing to AOT and transparently swap all required test packages and configurations to match this specialized mode.<\/p>\nMSTest.TestAdapter<\/code> NuGet package. The runner and its extensions consist of multiple NuGet packages to provide an extensible, flexible, and configurable test running experience. However, being customizable can result in many questions: What are the recommended extensions? What are the correct defaults? How do I align the versions? This is where the MSTest SDK comes in.<\/p>\nGetting started with MSTest SDK<\/h2>\n
.csproj<\/code> file with the following:<\/p>\n<Project Sdk=\"MSTest.Sdk\/3.3.1\">\r\n\r\n <PropertyGroup> \r\n <TargetFramework>net8.0<\/TargetFramework>\r\n <\/PropertyGroup>\r\n\r\n <!-- Additional properties and items for your tests. -->\r\n<\/Project> <\/code><\/pre>\nnet462<\/code> and above).<\/p>\nAdvantages of MSTest SDK<\/h2>\n
\n
Better defaults<\/h3>\n
Easier usage of MSTest Runner extensions<\/h3>\n
Default<\/code>, AllMicrosoft<\/code> and None<\/code>, that you can configure and further customize. With Default<\/code> profile being our recommendation.<\/p>\n\n
Enable[NugetPackageNameWithoutDots]<\/code>. For example, to add crash dump support to the default profile you can simply add the following MSBuild property EnableMicrosoftTestingExtensionsCrashDump<\/code> set to true<\/code>.<\/p>\n<Project Sdk=\"MSTest.Sdk\/3.3.1\">\r\n\r\n <PropertyGroup>\r\n <TargetFramework>net8.0<\/TargetFramework>\r\n <!-- Enable Microsoft.Testing.Extensions.CrashDump package on top of the default profile -->\r\n <EnableMicrosoftTestingExtensionsCrashDump>true<\/EnableMicrosoftTestingExtensionsCrashDump>\r\n <\/PropertyGroup>\r\n\r\n <!-- Additional properties and items for your tests. -->\r\n<\/Project> <\/code><\/pre>\nTesting Native AOT<\/h3>\n