.NET Core Source-Build

This repository contains infrastructure for building the .NET Core Runtime and SDK from source. The scripts allow .NET Core package maintainers to comply with common Linux distribution guidelines.

Using this repository

The scripts are written for Bash and supported on macOS and Linux. See Documentation for complete instructions.

The source-build repository doesn't currently support Windows. See source-build#1190.

Build on Linux or macOS

./build.sh

Once the build is successful, the built SDK tarball is placed at:

artifacts/${ARCHITECTURE}/Release/dotnet-sdk-${SDK_VERSION}-${RUNTIME_ID}.tar.gz

• ${ARCHITECTURE} is your platform architecture (probably x64)
• ${SDK_VERSION} is the SDK version you are building
• ${RUNTIME_ID} is your OS name and architecture (something like debian.9-x64 or fedora.33-x64)

For example, building a 3.1.105 SDK on an x64 (aka x86_64) platform running Fedora 32 will produce artifacts/x64/Release/dotnet-sdk-3.1.105-fedora.32-x64.tar.gz.

Goals

The key goal of this repository is to satisfy the official packaging rules of commonly used Linux distributions, such as Fedora and Debian. Many Linux distributions have similar rules. These rules tend to have two main principles: consistent reproducibility, and source code for everything.

A secondary goal of source-build is to allow .NET Core contributors to build a .NET Core SDK with coordinated changes in multiple repositories. However, the developer experience is significantly better in individual repositories and, if possible, contributors should make and test changes in the target repo, not source-build.

What does the source-build infrastructure do?

Source-build solves common challenges that most developers encounter when trying to build the whole .NET Core SDK from source.

• .NET Core is composed of many repositories that need to be built at a specific combination of commits.
• Each repository's build output needs to flow into the next repository's build.
• By default, most .NET Core repositories download prebuilt binary dependencies from online sources. These are forbidden by typical Linux distribution rules, and interfere with build output flow.
• Nearly all .NET Core repositories require the .NET Core SDK to build. This is a circular dependency, which presents a bootstrapping problem.

The source-build repository contains scripts and build logic to help Linux distribution maintainers address these challenges.

License

This repo is licensed under the MIT license.