This repo contains the .NET Core command-line (CLI) tools, used for building .NET Core apps and libraries through your development flow (compiling, NuGet package management, running, testing, ...).
C# Shell PowerShell HTML Visual Basic F# Other
Latest commit aa0359c Jan 23, 2017 @codito codito committed with piotrpMSFT Insert test platform v15.0.0-preview-20170123-02 (#5426)
* Insert test platform v15.0.0-preview-20160120-03.

Remove OutputType from test project templates since it is
automatically determined by Microsoft.NET.Test.Sdk.

* Update testplatform v15.0.0-preview-20170123-02.
Permalink
Failed to load latest commit information.
Documentation Create migration-issues.md (#5408) Jan 20, 2017
TestAssets [WIP] Reduce test target complexity [and running time] (#5403) Jan 22, 2017
build Insert test platform v15.0.0-preview-20170123-02 (#5426) Jan 23, 2017
build_projects Updating the branding on rel/1.0.0 to rc4. (#5267) Jan 12, 2017
packaging Updating the branding on rel/1.0.0 to rc4. (#5267) Jan 12, 2017
resources Return non-zero exit code for test failure in multitargeted test proj… Dec 16, 2016
scripts Updating the version of msbuild to 15.1.0-preview-000516-03 (#5266) Jan 11, 2017
src Insert test platform v15.0.0-preview-20170123-02 (#5426) Jan 23, 2017
test [WIP] Reduce test target complexity [and running time] (#5403) Jan 22, 2017
tools Update Microsoft.NETCore.App to 1.0.3. Jan 5, 2017
.cliversion [WIP] Removes *3 verbs, making msbuild the driver (#4456) Oct 28, 2016
.gitattributes merge my spike on compile/publish/run and switch from PS1 to C# Oct 6, 2015
.gitignore add *.xproj.user to backup file types Nov 16, 2016
.toolversions Use --disable-parallel during xplat restores. Oct 28, 2016
CONTRIBUTING.md Add contributing info and developer guide Nov 18, 2015
ISSUE_TEMPLATE issue template, the --info is the new --version Mar 31, 2016
LICENSE Initial commit Oct 2, 2015
Microsoft.DotNet.Cli.sln Bump MSBuild Version to 15.1.0-preview-000503-01 (#5199) Jan 5, 2017
NuGet.Config First step to ingest template engine (#5065) Jan 6, 2017
NuGet.master.config add readme Oct 8, 2015
PULL_REQUEST_TEMPLATE add PR template May 3, 2016
README.md Fix broken link in README.md Dec 28, 2016
THIRD-PARTY-NOTICES sln reader/writer (#4870) Dec 1, 2016
branchinfo.txt Updating the branding on rel/1.0.0 to rc4. (#5267) Jan 12, 2017
build.cmd Merge rel/1.0.0 into feature/msbuild. Jul 18, 2016
build.proj Bump MSBuild Version to 15.1.0-preview-000503-01 (#5199) Jan 5, 2017
build.sh Adding a comment about the code that removes empty spaces from the ar… Jul 12, 2016
clean.cmd Bringing run.exe into the repo and starting with the clean command Jul 26, 2016
clean.sh Bringing run.exe into the repo and starting with the clean command Jul 26, 2016
config.json Bringing run.exe into the repo and starting with the clean command Jul 26, 2016
dir.props Updating the branding on rel/1.0.0 to rc4. (#5267) Jan 12, 2017
dir.tasks Bump MSBuild Version to 15.1.0-preview-000503-01 (#5199) Jan 5, 2017
global.json Fix the update-dependencies project so it builds and runs again. May 17, 2016
netci.groovy update netci.groovy to use ubuntu.14.04 Jun 1, 2016
omnisharp.json Update omnisharp setting. Disable auto restore. Mar 27, 2016
run-build.ps1 Updating our projects and test assets to work with the latest SDK. Jan 6, 2017
run-build.sh Updating our projects and test assets to work with the latest SDK. Jan 6, 2017
run.cmd Bringing run.exe into the repo and starting with the clean command Jul 26, 2016
run.sh Bringing run.exe into the repo and starting with the clean command Jul 26, 2016

README.md

.NET Command Line Interface

.NET Slack Status Join the chat at https://gitter.im/dotnet/cli

This repo contains the source code for cross-platform .NET Core command line toolchain. It contains the implementation of each command, the native packages for various supported platforms as well as documentation.

Preview 4 release - MSBuild based tools

As was outlined in the "Changes to project.json" blog post, we have started work to move away from project.json to csproj and MSBuild. All the new latest releases from this repo (from rel/1.0.0 branch) are MSBuild-enabled tools.

The current official release of the csproj-enabled CLI tools is CLI Preview 4.

There are a couple of things to keep in mind:

  • Preview 4 CLI bits are still in development so some rough edges are to be expected.
  • Preview 4 bits do not support project.json so you will have to either keep Preview 2 tools around or migrate your project. You can find more information on this using the project.json to csproj instructions.
  • Preview 4 refers to the CLI tools only and does not cover Visual Studio, VS Code or Visual Studio for Mac.
  • We welcome any and all issues that relate to MSBuild-based tools, so feel free to try them out and leave comments and file any bugs/problems.

Download links

Found an issue?

You can consult the known issues page to find out the current issues and to see the workarounds.

If you don't find your issue, please file one! However, given that this is a very high-frequency repo, we've setup some basic guidelines to help you. Please consult those first.

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.

Build Status

Ubuntu 14.04 / Linux Mint 17 Ubuntu 16.04 Debian 8.2 Windows x64 Windows x86 Mac OS X CentOS 7.1 / Oracle Linux 7.1 RHEL 7.2 OpenSUSE 13.2 Fedora 23

Installers and Binaries

You can download .NET Core as either an installer (MSI, PKG) or a zip (zip, gzip). You can download the product in two flavors:

  • .NET Core - .NET Core runtime and framework
  • .NET Core SDK - .NET Core + CLI tools

Note: please be aware that below installers are the latest bits. If you want to install the latest released versions, please check out the section above.)

Version .NET Core Installer .NET Core SDK Installer .NET Core Binaries .NET Core SDK Binaries
Windows x64 Download Download Checksums Download Download Checksums
Windows x86 Download Download Checksums Download Download Checksums
Ubuntu 14.04 / Linux Mint 17 See Below See Below Download Download Checksums
Ubuntu 16.04 N/A N/A Download Download Checksums
Debian 8.2 N/A N/A Download Download Checksums
Mac OS X Download Download Checksums Download Download Checksums
CentOS 7.1 / Oracle Linux 7 N/A N/A Download Download Checksums
RHEL 7.2 N/A N/A Download Download Checksums
openSUSE 13.2 N/A N/A Download Download Checksums
Fedora 23 N/A N/A Download Download Checksums

Ubuntu Installers

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 these directly from the .deb files (via dpkg or similar), then you'll need to install them in the order presented below.

**For Ubuntu 14.04

Version Installers
Shared Host Download
Host Framework Resolver Download
Shared Framework Download
Sdk Download

Docker

You can also use our Docker base images found on https://hub.docker.com/r/microsoft/dotnet to set up your dev or testing environment for usage.

Basic usage

When you have the .NET Command Line Interface installed on your OS of choice, you can try it out using some of the samples on the dotnet/core repo. You can download the sample in a directory, and then you can kick the tires of the CLI.

First, you will need to restore the packages:

dotnet restore

This will restore all of the packages that are specified in the project.json file of the given sample.

Then you can either run from source or compile the sample. Running from source is straightforward:

dotnet run

Compiling to IL is done using:

dotnet build

This will drop an IL assembly in ./bin/[configuration]/[framework]/[binary name] that you can run using dotnet bin/[configuration]/[framework]/[binaryname.dll].

For more details, please refer to the documentation.

Building from source

If you are building from source, take note that the build depends on NuGet packages hosted on MyGet, so if it is down, the build may fail. If that happens, you can always see the MyGet status page for more info.

Read over the contributing guidelines and developer documentation for prerequisites for building from source.

Questions & Comments

For any and all feedback, please use the Issues on this repository.

License

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