dotnet/toolset

Name: toolset

Owner: .NET Foundation

Description: .NET Core Toolset

Created: 2017-09-23 00:03:45.0

Updated: 2018-04-15 12:57:00.0

Pushed: 2018-02-23 21:11:44.0

Homepage: null

Size: 30828

Language: C#

GitHub Committers

UserMost Recent Commit# Commits

Other Committers

UserEmailMost Recent Commit# Commits

README

.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 and the documentation.

Looking for V1 of the .NET Core tooling?

If you are looking for the v1.0.1 release of the .NET Core tools (CLI, MSBuild and the new csproj), see https://dot.net/core.

Note: the release/2.0.0 branch of the CLI repo is based on an upcoming update of the SDK and is considered pre-release. For production-level usage, please use the released version of the tools available at https://dot.net/core

Found an issue?

You can consult the Documents Index 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

|Windows x64 |Windows x86 |Mac OS X |Linux x64 |Ubuntu 14.04 / Linux Mint 17 |Ubuntu 16.04 |Ubuntu 16.10 |Debian 8 |RHEL 7.2 | |:——:|:——:|:——:|:——:|:——:|:——:|:——:|:——:|:——:| ||||||||||

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.

To download the .NET Core runtime without the SDK, visit https://github.com/dotnet/core-setup#daily-builds.

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.

| Platform | Latest Daily Build
release/2.0.0
| | ——– | :————————————-: | | Windows x64 | Installer - Checksum
zip - Checksum | | Windows x86 | Installer - Checksum
zip - Checksum | | Mac OS X | Installer - Checksum
tar.gz - Checksum | | Linux x64 | tar.gz - Checksum | | Ubuntu 14.04 / Linux Mint 17 | Installer - Checksum
see installer note below1
tar.gz - See Linux x64 | | Ubuntu 16.04 | Installer - Checksum
see installer note below1
tar.gz - See Linux x64 | | Ubuntu 16.10 | Installer - Checksum
see installer note below1
tar.gz - See Linux x64 | | Debian 8 | Installer - Checksum
see installer note below1
tar.gz - See Linux x64 | | RHEL 7.2 | Installer - Checksum
see installer note below1
tar.gz - See Linux x64 | | CentOS 7.1 / Oracle Linux 7 | tar.gz - See Linux x64 | | Fedora 24 | tar.gz - See Linux x64 | | OpenSUSE 42.1 | tar.gz - See Linux x64 |

| Latest Coherent Build2
release/2.0.0 | |:——:| | |

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 these directly from the .deb files (via dpkg or similar), then you'll need to install the corresponding Host, Host FX Resolver, and Shared Framework packages before installing the Sdk package.

2: A 'coherent' build is defined as a build where the Runtime version matches between the CLI and Asp.NET.

Debian daily feed

Newest SDK binaries for 2.0.0 in debian feed may be delayed due to external issues by up to 24h.

Obtaining binaries
Add debian feed:

Ubuntu 14.04

 sh -c 'echo "deb [arch=amd64] http://apt-mo.trafficmanager.net/repos/dotnet/ trusty main" > /etc/apt/sources.list.d/dotnetdev.list'

 apt-key adv --keyserver apt-mo.trafficmanager.net --recv-keys 417A0893

 apt-get update

Ubuntu 16.04

 sh -c 'echo "deb [arch=amd64] http://apt-mo.trafficmanager.net/repos/dotnet/ xenial main" > /etc/apt/sources.list.d/dotnetdev.list'

 apt-key adv --keyserver apt-mo.trafficmanager.net --recv-keys 417A0893

 apt-get update

Ubuntu 16.10

 sh -c 'echo "deb [arch=amd64] http://apt-mo.trafficmanager.net/repos/dotnet/ yakkety main" > /etc/apt/sources.list.d/dotnetdev.list'

 apt-key adv --keyserver apt-mo.trafficmanager.net --recv-keys 417A0893

 apt-get update

Debian 8

 sh -c 'echo "deb [arch=amd64] http://apt-mo.trafficmanager.net/repos/dotnet/ jessie main" > /etc/apt/sources.list.d/dotnetdev.list'

 apt-key adv --keyserver apt-mo.trafficmanager.net --recv-keys 417A0893

 apt-get update
Install:
 apt-get install <DebianPackageName>=<Version>
To list available packages:
cache search dotnet-sdk | grep 2.0.0
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, 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 all feedback, use the Issues on this repository.

License

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


This work is supported by the National Institutes of Health's National Center for Advancing Translational Sciences, Grant Number U24TR002306. This work is solely the responsibility of the creators and does not necessarily represent the official views of the National Institutes of Health.