/cli

Permalink
192 lines (126 sloc) 12.1 KB

.NET Command Line Interface

.NET Slack StatusJoin 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.

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), head over tohttps://dot.net/core and download!

Note: the master branch of the CLI repo is based on the upcoming v2 of .NET Core and is considered pre-release. For production-level usage, please use thev1 of the tools.

Found an issue?

You can consult theknown 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 somebasic guidelines to help you. Please consult those first.

This project has adopted the code of conduct defined by theContributor 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 17Ubuntu 16.04Debian 8.2Windows x64Windows x86macOSCentOS 7.1 / Oracle Linux 7.1RHEL 7.2Linux x64

Installers and Binaries

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

In order to download just the .NET Core runtime without the SDK, please visithttps://github.com/dotnet/core-setup#daily-builds.

Note: please be aware that below installers are thelatest bits. If youwant to install the latest released versions, please check out thesection above.

Platformmaster
Windows x64Installer -Checksum
zip -Checksum
Windows x86Installer -Checksum
zip -Checksum
Ubuntu 14.04 / Linux Mint 17Installer -Checksum
*See Installer Note Below
tar.gz -Checksum
Ubuntu 16.04tar.gz -Checksum
Debian 8.2tar.gz -Checksum
macOSInstaller -Checksum
tar.gz -Checksum
CentOS 7.1 / Oracle Linux 7tar.gz -Checksum
RHEL 7.2tar.gz -Checksum
Linux x64tar.gz -Checksum

Note: 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 thecorresponding Host, Host FX Resolver, and Shared Framework packages before installing the Sdk package.

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:

sudo sh -c 'echo "deb [arch=amd64] http://apt-mo.trafficmanager.net/repos/dotnet/ trusty main" > /etc/apt/sources.list.d/dotnetdev.list'sudo apt-key adv --keyserver apt-mo.trafficmanager.net --recv-keys 417A0893sudo apt-get update

Install:

sudo apt-get install <DebianPackageName>=<Version>

To list available packages:

apt-cache search dotnet-sdk | grep 2.0.0

Docker

You can also use our Docker base images found onhttps://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 thedotnet/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 usingdotnet bin/[configuration]/[framework]/[binaryname.dll].

For more details, please refer to thedocumentation.

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 theMyGet status page for more info.

Read over thecontributing guidelines anddeveloper 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 projectEULA.