This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.
- Use Windows PowerShell or PowerShell Core to run .ps1 scripts. Some scripts set environment variables to help you, but they are only retained if you use PowerShell as your shell.
All dependencies can be installed by running the init.ps1
script at the root of the repository
using Windows PowerShell or PowerShell Core.
Some dependencies installed by init.ps1
may only be discoverable from the same command line environment the init script was run from due to environment variables, so be sure to launch Visual Studio or build the repo from that same environment.
Alternatively, run init.ps1 -InstallLocality Machine
(which may require elevation) in order to install dependencies at machine-wide locations so Visual Studio and builds work everywhere.
The only prerequisite for building, testing, and deploying from this repository
is the .NET SDK.
You should install the version specified in global.json
or a later version within
the same major.minor.Bxx "hundreds" band.
For example if 2.2.300 is specified, you may install 2.2.300, 2.2.301, or 2.2.310
while the 2.2.400 version would not be considered compatible by .NET SDK.
See .NET Core Versioning for more information.
The easiest way to restore packages may be to run init.ps1
which automatically authenticates
to the feeds that packages for this repo come from, if any.
dotnet restore
or nuget restore
also work but may require extra steps to authenticate to any applicable feeds.
This repository can only be built on Windows.
Building, testing, and packing this repository can be done by using the standard MSBuild targets from a Visual Studio 2019 Developer Command Prompt (e.g. MSBuild /t:Build
, MSBuild /t:Pack
, etc.). Testing can be performed with dotnet test
.