Building xUnit.net

The primary build system for xUnit.net is done via command line, and officially supports Linux and Windows. Users running macOS can generally follow the Linux instructions (while installing the macOS equivalents of the dependencies).

Pre-Requisites

You will need the following software installed (regardless of OS):

.NET SDK 9.0
.NET Runtime 8.0
git

Linux Pre-Requisites

Linux users will additionally need:

Mono 6.12+ w/ MSBuild 16.6+
bash for the build script (does not need to be your default shell)

Windows Pre-Requisites

Windows users will additionally need:

.NET Framework 4.8.1 or later (part of the Windows OS)
PowerShell (or PowerShell Core)

Ensure that you have configured PowerShell to be able to run local unsigned scripts (either by running Set-ExecutionPolicy RemoteSigned from within PowerShell, or by launching PowerShell with the -ExecutionPolicy RemoteSigned command line switch).

Command-Line Build

Linux users: Open a terminal to your favorite shell.

Windows users: Open PowerShell (or PowerShell Core).
From the root folder of the source repo, this command will build the code and run all tests:

./build

To build a specific target (or multiple targets):

./build [target [target...]]

The common targets (case-insensitive) include:
- Restore: Perform package restore
- Build: Build the source
- Test: Run all unit tests
- TestCore: Run all unit tests (.NET Core)
- TestFx: Run all unit tests (.NET Framework)
- Packages: Create NuGet packages
You can get a list of options:

./build --help

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!