Skip to content

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, ...).

License

noahfalk/cli

 
 

Repository files navigation

.NET Command Line Interface

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.

New to .NET CLI?

Check out our http://dotnet.github.io/getting-started/

Build Status

Ubuntu 14.04 Windows Mac OS X CentOS 7.1

Installers

Ubuntu 14.04 Windows Mac OS X CentOS 7.1
Version
Installers Download Debian Package Download Msi Download Pkg N/A
Binaries Download tar file Download zip file Download tar file Download tar file

Interested in .NET Core + ASP.NET 5 RC bits?

This toolchain is independent from the DNX-based .NET Core + ASP.NET 5 RC bits. If you are looking for .NET Core + ASP.NET 5 RC bits, you can find instructions on the http://get.asp.net/.

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 a binary in ./bin/[configuration]/[framework]/[binary name] that you can just run.

Finally, you can also try out native compilation using RyuJIT as shown below:

dotnet build --native

The following command will perform native compilation using the C++ Codegenerator:

dotnet build --native --cpp

If you are in Windows, make sure that you run the above command inside the VS 2015 x64 Native Tools prompt, otherwise you will get errors. This command will drop a native single binary in ./bin/[configuration]/[framework]/native/[binary name] that you can run.

Note: At this point, only the helloworld and dotnetbot samples will work with native compilation.

For more details, please refer to the documentation.

Building .Net CLI from source

See the developer guide.

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.

Known issues

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

Questions & Comments

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

About

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, ...).

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • C# 87.8%
  • C++ 4.5%
  • Shell 3.4%
  • PowerShell 2.0%
  • HTML 1.6%
  • CMake 0.3%
  • Other 0.4%