About xUnit.net

xUnit.net is a free, open source, community-focused unit testing tool for the .NET Framework. Written by the original inventor of NUnit v2, xUnit.net is the latest technology for unit testing C#, F#, VB.NET and other .NET languages. xUnit.net works with ReSharper, CodeRush, TestDriven.NET and Xamarin. It is part of the .NET Foundation, and operates under their code of conduct. It is licensed under Apache 2 (an OSI approved license).

Follow: xUnit.net on Mastodon, James Newkirk, Brad Wilson, Claire Novotny
Discussions are held on our discussions site.
Resharper support is provided and supported by JetBrains.
CodeRush support is provided and supported by DevExpress.
NCrunch support is provided and supported by Remco Software.
The xUnit.net logo was designed by Nathan Young.

Table of Contents

• Packages and Builds
• Documentation
• Release Notes
• Test Runner Compatibility
• Github Projects
• Links to Resources
• Additional copyrights

Packages and Builds

	Stable	Latest prerelease	Latest CI	CI status
v2 core framework
v3 core framework (alpha docs)	N/A	N/A
xunit.analyzers
xunit.runner.visualstudio

Documentation

Getting Started

New to xUnit.net? These guides will help you get started.

• .NET Core & .NET 5+ – cross-platform applications, including ASP.NET Core
  • Using command line (cross-platform)
  • Using Visual Studio (Windows)
• .NET Framework – Windows desktop & server applications, including ASP.NET
  • Using command line (cross-platform)
  • Using Visual Studio (Windows)
  • Using JetBrains Rider (cross-platform)
• Miscellaneous Topics
  • What NuGet packages should I use?
  • xUnit.net analyzer documentation
  • Multi-targeting on non-Windows OSes

Configuration

• Configuration files (aka xunit.runner.json)
• RunSettings and xunit.runner.visualstudio
• What is the JSON schema for xunit.runner.json?

Unit Test Parallelism

• Running tests in parallel
• Sharing context between tests (class and collection fixtures)

Other Topics

• Sample projects (including testing and extensibility)
• Capturing output
• Running tests in MSBuild
• Getting Test Results in TeamCity
• Getting Test Results in CruiseControl.NET
• Getting Test Results in Azure DevOps

Frequently Asked Questions

• Why did we build xUnit 1.0?
• What is the format of the XML generated by the test runners?
• Comparing xUnit.net to other frameworks
• Building xUnit.net
• Why doesn't xUnit.net support netstandard?
• Theory data stability

Migration

• Migrating unit tests from v1 to v2
• Where to find code that used to live in xunit.extensions
• Migrating from MSTest to xUnit.net

Release Notes

v2 Core Framework
Version	Releases
2.5.2	Build 2
2.5.1	RTM Build 33 Build 26 Build 20 Build 12 Build 11
2.5.0	RTM Build 44 Build 37 Build 26 Build 22 Build 11
2.4.2	RTM Build 27 Build 12
2.4.1	RTM Build 4071 Build 4059
2.4	RTM RC 2 RC 1 Beta 2 Beta 1
2.3.1	RTM RC 2 RC 1
2.3	RTM RC 3 RC 2 RC 1 Beta 5 Beta 4 Beta 3 Beta 2 Beta 1
2.2	RTM Beta 4 Beta 3 Beta 2 Beta 1
2.1	RTM RC 2 RC 1 Beta 4 Beta 3 Beta 2 Beta 1
2.0.1	RTM RC 1
2.0	RTM RC 4 RC 3 RC 2 RC 1 Beta 5

xunit.analyzers
Version	Releases
1.3.0	RTM Build 19 Build 13 Build 6
1.2.0	RTM Build 48 Build 27 Build 24 Build 9 Build 7
1.1.0	RTM
1.0.0	RTM

xunit.runner.visualstudio
Version	Releases
2.5.2	Build 3
2.5.1	RTM Build 15 Build 11 Build 10 Build 4
2.5.0	RTM Build 27 Build 22 Build 20 Build 15

Test Runner Compatibility

	xUnit.net	xunit.console	MSBuild	TestDriven.NET	Visual Studio 2	Devices
.NET Framework (Windows)	1.9.2+	✓ 3a	✓ 3a	✓ 3a	✓ 3b (2012+)
.NET Core & .NET 5+ (Windows, Linux, OS X)	2.2+				✓ 3b (2017+)
	↓ The project types below have been officially deprecated ↓
Universal Application (Windows 8.1, Windows Phone 8.1)	2.0 - 2.1				✓ 3b (2013+)	✓ 3c
Universal Windows Platform	2.1 - 2.4.2				✓ 3b (2015+)	✓ 3c
Windows Phone 8 (Silverlight)	2.0 - 2.1					✓ 3c
Xamarin iOS Unified 1	2.0 - 2.4.2					✓ 3c
Xamarin MonoAndroid 1	2.0 - 2.4.2					✓ 3c
Xamarin MonoTouch (iOS Classic) 1	2.0 - 2.1					✓ 3c
Requires Xamarin for Visual Studio or Xamarin Studio. Visual Studio support includes the Visual Studio Test Explorer, Visual Studio Code, vstest.console.exe, and dotnet test. Express editions of Visual Studio are not supported. Test runner source code availability: a. https://github.com/xunit/xunit b. https://github.com/xunit/visualstudio.xunit c. https://github.com/xunit/devices.xunit

Github Projects

For information on contributing to xUnit.net, please read the governance document.

• xUnit.net (core framework, built-in runners)
• Assertion library
• Analyzers
• Visual Studio runner (Visual Studio, Visual Studio Code, dotnet test)
• Media files
• This site

Links to Resources

• Visual Studio Community
• .NET Framework 4.5.2
• TestDriven.NET
• MSBuild Reference

Additional copyrights

Portions copyright The Legion Of The Bouncy Castle

Copyright © .NET Foundation. Contributions welcomed at https://github.com/xunit/xunit/tree/gh-pages.