.NET Core SDK

This repo contains the source code for the cross-platform .NET Core SDK. It aggregates the .NET Toolchain, the .NET Core runtime, the templates, and the .NET Core Windows Desktop runtime. It produces zip, tarballs, and native packages for various supported platforms.

Looking for released versions of the .NET Core tooling?

Download released versions of the .NET Core tools (CLI, MSBuild and the new csproj) at https://dot.net/core.

Found an issue?

You can consult the Documents Index for the SDK repo to find out current issues, see workarounds, and to see how to file new issues.

This project has adopted the code of conduct defined by the Contributor Covenant to clarify expected behavior in our community. For more information, see the .NET Foundation Code of Conduct.

Building

The repository contains native code project required for the Windows installer. If you intend to build it locally on Windows, you will need to ensure that you have the following items installed.

• Install CMAKE 3.21.0 is required if you're building VS 17.0. Make sure to add CMAKE to your PATH (the installer will prompt you).

• Install MSVC Build tools for x86/x64/arm64, v14.28-16.9

• build for basic build

• build -pack to build the installer

• To build in VS, run a command line build first, then run artifacts\core-sdk-build-env.bat from a VS command prompt and then devenv Microsoft.DotNet.Cli.sln

• To test different languages of the installer, run artifacts\packages\Debug\Shipping>dotnet-sdk-3.1.412-win-x64.exe /lang 1046 using the LCID of the language you want to test

Building (source-build)

This repo also contains code to help you build the entire .NET product end-to-end from sources (often referred to as source-build), even in disconnected/offline mode. This is currently only tested on Linux.

1. ./build.sh /p:ArcadeBuildTarball=true /p:TarballDir=/path/to/place/complete/dotnet/sources

   This fetches the complete set of source code used to build the .NET SDK. It creates a tarball of the complete .NET source code at artifacts/packages/<Release|Debug>/Shipping/. It also places the extracted sources at /path/to/place/complete/dotnet/sources. Due to a few known issues, that source directory should be outside (and not somewhere under) this repository.

2. cd /path/to/complete/dotnet/sources

3. ./prep.sh --bootstrap

   This downloads a .NET SDK and a number of .NET packages and other prebuilts needed to build .NET from source.

   Eventually, we want to make it possible to bootstrap .NET 6 in which case this step can be skipped.

4. ./build.sh

   This builds the entire .NET SDK. The resulting SDK is placed at artifacts/$ARCH/Release/dotnet-sdk-$VERSION-$ARCH.tar.gz.

Build status

All legs

Installers and Binaries

You can download the .NET Core SDK as either an installer (MSI, PKG) or a zip (zip, tar.gz). The .NET Core SDK contains both the .NET Core runtime and CLI tools.

Note: Be aware that the following installers are the latest bits. If you want to install the latest released versions, check out the preceding section. With development builds, internal NuGet feeds are necessary for some scenarios (for example, to acquire the runtime pack for self-contained apps). You can use the following NuGet.config to configure these feeds. See the following document Configuring NuGet behavior for more information on where to modify your NuGet.config to apply the changes.

Example:

For .NET 6 builds

<configuration>
  <packageSources>
    <add key="dotnet6" value="https://pkgs.dev.azure.com/dnceng/public/_packaging/dotnet6/nuget/v3/index.json" />
  </packageSources>
</configuration>

Note: that you may need to add the dotnet5 feed for a short period of time while .NET transitions to .NET 6

For .NET 6 Optional workloads

We strongly recommend using --skip-manifest-update with dotnet workload install as otherwise you could pick up a random build of various workloads as we'll automatically update to the newest one available on the feed.

<configuration>
  <packageSources>
    <add key="maui" value="https://pkgs.dev.azure.com/azure-public/vside/_packaging/xamarin-impl/nuget/v3/index.json" />
  </packageSources>
</configuration>

For .NET 5 builds

<configuration>
  <packageSources>
    <add key="dotnet5" value="https://pkgs.dev.azure.com/dnceng/public/_packaging/dotnet5/nuget/v3/index.json" />
  </packageSources>
</configuration>

For .NET 3.1 builds

<configuration>
  <packageSources>
    <add key="dotnet3.1" value="https://pkgs.dev.azure.com/dnceng/public/_packaging/dotnet3.1/nuget/v3/index.json" />
  </packageSources>
</configuration>

Please do not directly edit the table below. Use https://github.com/dotnet/installer/tree/main/tools/sdk-readme-table-generator to help you generate it. Make sure to run the table generator test and make any changes to the generator along with your changes to the table.

Platform	Release/6.0.1XX (6.0.x Runtime)	Release/6.0.1XX-rc1 (6.0 Runtime)	Release/5.0.4XX (5.0 Runtime)	Release/5.0.2XX (5.0 Runtime)	Release/3.1.4XX (3.1.x Runtime)	Release/3.1.1XX (3.1.x Runtime)
Windows x64	Installer - Checksum zip - Checksum	Installer - Checksum zip - Checksum	Installer - Checksum zip - Checksum	Installer - Checksum zip - Checksum	Installer - Checksum zip - Checksum	Installer - Checksum zip - Checksum
Windows x86	Installer - Checksum zip - Checksum	Installer - Checksum zip - Checksum	Installer - Checksum zip - Checksum	Installer - Checksum zip - Checksum	Installer - Checksum zip - Checksum	Installer - Checksum zip - Checksum
Windows arm	N/A	N/A	N/A	N/A	zip - Checksum	zip - Checksum
Windows arm64	Installer - Checksum zip	Installer - Checksum zip	Installer - Checksum zip	Installer - Checksum zip	N/A	N/A
macOS x64	Installer - Checksum tar.gz - Checksum	Installer - Checksum tar.gz - Checksum	Installer - Checksum tar.gz - Checksum	Installer - Checksum tar.gz - Checksum	Installer - Checksum tar.gz - Checksum	Installer - Checksum tar.gz - Checksum
macOS arm64	Installer - Checksum tar.gz - Checksum	Installer - Checksum tar.gz - Checksum	N/A	N/A	N/A	N/A
Linux x64	DEB Installer - Checksum RPM Installer - Checksum see installer note below1 tar.gz - Checksum	DEB Installer - Checksum RPM Installer - Checksum see installer note below1 tar.gz - Checksum	DEB Installer - Checksum RPM Installer - Checksum see installer note below1 tar.gz - Checksum	DEB Installer - Checksum RPM Installer - Checksum see installer note below1 tar.gz - Checksum	DEB Installer - Checksum RPM Installer - Checksum see installer note below1 tar.gz - Checksum	DEB Installer - Checksum RPM Installer - Checksum see installer note below1 tar.gz - Checksum
Linux arm	tar.gz - Checksum	tar.gz - Checksum	tar.gz - Checksum	tar.gz - Checksum	tar.gz - Checksum	tar.gz - Checksum
Linux arm64	tar.gz - Checksum	tar.gz - Checksum	tar.gz - Checksum	tar.gz - Checksum	tar.gz - Checksum	tar.gz - Checksum
Linux-musl-x64	tar.gz - Checksum	tar.gz - Checksum	tar.gz - Checksum	tar.gz - Checksum	tar.gz - Checksum	tar.gz - Checksum
Linux-musl-arm	tar.gz - Checksum	tar.gz - Checksum	tar.gz - Checksum	tar.gz - Checksum	N/A	N/A
Linux-musl-arm64	tar.gz - Checksum	tar.gz - Checksum	tar.gz - Checksum	tar.gz - Checksum	N/A	N/A
RHEL 6	N/A	N/A	N/A	N/A	tar.gz - Checksum	tar.gz - Checksum

Reference notes:

1: Our Debian packages are put together slightly differently than the other OS specific installers. Instead of combining everything, we have separate component packages that depend on each other. If you're installing the SDK from the .deb file (via dpkg or similar), then you'll need to install the corresponding dependencies first:

• Host, Host FX Resolver, and Shared Framework
• ASP.NET Core Shared Framework

.NET Core SDK 2.x downloads can be found here: .NET Core SDK 2.x Installers and Binaries

Looking for dotnet-install sources?

Sources for dotnet-install.sh and dotnet-install.ps1 are in the install-scripts repo.

Questions & Comments

For all feedback, use the Issues on the .NET CLI repository.

License

By downloading the .zip you are agreeing to the terms in the project EULA.