A repository to track efforts to produce a source tarball of the .NET Core SDK and all its components
Clone or download
dagood Merge pull request #773 from dotnet-maestro-bot/merge/release/2.2-to-…
…master

[automated] Merge branch 'release/2.2' => 'master'
Latest commit 92546b3 Sep 14, 2018
Permalink
Failed to load latest commit information.
.vsts.pipelines [release/2.1.3] Warn on online baseline failure for offline legs (#763) Sep 10, 2018
Documentation Change default bootstrap type to release (#656) Jul 24, 2018
cross Addes source.list for x86 (#684) Aug 7, 2018
docker Remove old docker files and add doc for using docker (#749) Sep 6, 2018
keys Add Newtonsoft.Json Mar 8, 2017
patches Merge branch 'release/2.2' into master Sep 13, 2018
repos Merge branch 'release/2.2' into master Sep 13, 2018
scripts Update build docs and fix bash shebangs (#150) Aug 22, 2018
src Merge branch 'release/2.2' into master Sep 13, 2018
support/tarball Update build docs and fix bash shebangs (#150) Aug 22, 2018
tools-local Update prebuilt baselines: submodule updates Sep 14, 2018
.gitattributes Fix patch line endings to work correctly on Windows. Sep 18, 2017
.gitignore Use VersionTools submodule updaters (#254) Nov 21, 2017
.gitmodules Update source-build master to core repo masters (#658) Jul 20, 2018
BuildToolsVersion.txt Update core repos tip to latest master (#645) Jul 18, 2018
DotnetCLIVersion.txt Update core repos tip to latest master (#645) Jul 18, 2018
LICENSE.txt Add README (#101) Aug 14, 2017
NuGet.Config Add vstest to known good (#396) Apr 6, 2018
ProdConFeed.txt Update ProdCon feed to 20180515-07 (#562) May 17, 2018
README.md Update build docs and fix bash shebangs (#150) Aug 22, 2018
arm-ci.sh Update build docs and fix bash shebangs (#150) Aug 22, 2018
armdeps.sh Update build docs and fix bash shebangs (#150) Aug 22, 2018
build-source-tarball.sh Merge branch 'release/2.2' into merge/release/2.2-to-master Sep 11, 2018
build.cmd Enable building on Windows Jan 5, 2017
build.proj Merge branch 'release/2.2' into merge/release/2.2-to-master Sep 11, 2018
build.ps1 Update core repos to master, buildtools version and some tweaks to be… Jun 20, 2018
build.sh Update build docs and fix bash shebangs (#150) Aug 22, 2018
check-submodules.ps1 Add scripts to make working with submodules easier. (#283) Nov 13, 2017
check-submodules.sh Update build docs and fix bash shebangs (#150) Aug 22, 2018
clean.cmd Use common clean.cmd/sh commands Sep 22, 2017
clean.sh Fix clean.sh permissions May 22, 2018
dependencies.props Merge branch 'release/2.2' into 'master' Aug 22, 2018
dependencies.targets Auto-update aspnet package versions from ProdCon Jul 24, 2018
dir.props Merge branch 'release/2.2' into master Sep 13, 2018
dir.targets Merged PR 130469: Add ability to specify the ProdConBlobFeedUrl for b… Jul 2, 2018
extract-patches.sh Update build docs and fix bash shebangs (#150) Aug 22, 2018
fetch-vsts-commits.ps1 Add "vsts_prodcon_update" build Jul 12, 2018
fetch-vsts-commits.sh Merged PR 130648: Update to ProdCon 2.1.2 (20180618-01) Jul 2, 2018
init-tools.cmd Add CoreFx to known-project list and move to tip of release/2.1 branch ( Apr 3, 2018
init-tools.msbuild Auto-update submodules to the commits used in latest ProdCon build (#371 Mar 27, 2018
init-tools.sh Move repos to RC (#459) Apr 20, 2018
netci.groovy Merge branch 'release/2.2' into merge/release/2.2-to-master Sep 11, 2018
smoke-test.sh Update build docs and fix bash shebangs (#150) Aug 22, 2018
smoke-testNuGet.Config Merged PR 130846: Add archiving of packages restored during smoke-test Jul 3, 2018

README.md

.NET Core Build Scripts

Join the chat at https://gitter.im/dotnet/source-build

OS Release Debug
CentOS7.1 Build Status Build Status
CentOS7.1 (Tarball) Build Status Build Status
Debian8.4 Build Status Build Status
Fedora28 Build Status Build Status
OSX10.12 Build Status Build Status
RHEL7.2 Build Status Build Status
RHEL7.2 (Tarball) Build Status Build Status
RHEL7.2 (Unshared) Build Status Build Status
Ubuntu16.04 Build Status Build Status
Windows Build Status Build Status

This repository contains a set of scripts for building the .NET Core Runtime and SDK from source. The scripts were built to make it easy for anyone to build the .NET Core product.

You can use these scripts to build the .NET Core product for Windows, macOS or Linux. See Documentation for complete instructions.

Using the Scripts

The scripts are supported on Windows, macOS and Linux. The scripts are based on PowerShell on Windows and Bash on macOS and Linux. Currently, Windows scripts only build through core-setup and do not build the complete SDK.

If you are building on Windows or OSX, building is possible via Docker. (https://hub.docker.com/r/microsoft/dotnet/)

Build on Windows

./build.ps1

Build on Linux or macOS

./build.sh

Script Users

The most common users are expected to be:

  • .NET Core contributors.
  • Linux distribution maintainers.
  • Cloud service developers.

You do not have to build the entire product to contribute to .NET Core. Often, you only need to build a single binary to test a change. There are some scenarios where building the whole product is useful, such as adding and testing a feature that requires changes to multiple repos.

What the Scripts Do

The scripts can be thought of as solving challenges that would otherwise making building the whole product difficult. The following challenges are the primary ones that developers often hit before these scripts were available.

  • .NET Core is composed of several repositories that all need to be built.
  • The .NET Core SDK generated by the build requires a specific layout in order to correctly function.
  • Most of the product is written in managed code and requires the .NET Core SDK to build. This approach is a great use of the product, but presents a boot-strapping problem for the build.

Goals

Many Linux distributions have specific rules for official packages. The rules can be summarized as two main rules: source for everything, and consistent reproducability.

A key goal of this repository was to satisfy the official packaging rules of commonly used Linux distributions, such as Fedora and Debian.

License

This repo is licensed with MIT.