a5aba4929a
* dotnet/release/2.0.0: (27 commits) Updating the runtime to pick up the satellite assembly host fix. Fixing some merges from release/2.0.0-preview2. Create the Dotnet User Profile folder when running the first experience, if the folder does not exist, if will fail the first run because it will fail to create the first notice sentinel. Add F# and Roslyn satellites Fix tests expecting unlocalized messages from dotnet/sdk Generating a layout folder with the satellite assemblies only which we use to generate a language pack tarball/zip. Initially, I wanted a IncludeOnlyFilter, but couldn't quite get that to work on tar, just passing the filter in the command line didn't work because the shell does not do recursive globbing. So, I opted for the layout folder. Update SPA templates version to 1.0.0-preview-000321 Fix dotnet/sdk#1364 Add rhel and Debian download link Exclude satellite assemblies from archive. Remove failed workaround for Microsoft.Composition warning Update templates to add missing BrowserLink package Update to SetupCrossgen 215 - Coherence 25794 Update templates to suppress the warning for Microsoft.Composition and AssetTargetFallback Add explicit dependency for pakcage smoke test Update templates to remove the package NETStandard.Library.NETFramework Update F# compiler to latest Update to SetupCrossgen 213 - Coherence 25769 Pinning to the dotnet-install to version '2.0.0-preview2-006470' Updating branch/channel information. ...
13 KiB
.NET Command Line Interface
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 to https://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 the v1 of the tools.
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
| Ubuntu 14.04 / Linux Mint 17 | Ubuntu 16.04 | Ubuntu 16.10 | Debian 8 | Windows x64 | Windows x86 | macOS | CentOS 7.1 / Oracle Linux 7.1 | RHEL 7.2 | Linux 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 visit https://github.com/dotnet/core-setup#daily-builds.
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.
| Platform | master |
|---|---|
| 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 Below tar.gz - See Linux x64 |
| Ubuntu 16.04 | Installer - Checksum *See Installer Note Below tar.gz - See Linux x64 |
| Ubuntu 16.10 | Installer - Checksum *See Installer Note Below tar.gz - See Linux x64 |
| Debian 8 | Installer - Checksum *See Installer Note Below tar.gz - See Linux x64 |
| CentOS 7.1 / Oracle Linux 7 | tar.gz - See Linux x64 |
| RHEL 7.2 | Installer - Checksum *See Installer Note Below tar.gz - See Linux x64 |
| Fedora 24 | tar.gz - See Linux x64 |
| OpenSUSE 42.1 | tar.gz - See Linux x64 |
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 the corresponding 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:
Ubuntu 14.04
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 417A0893
sudo apt-get update
Ubuntu 16.04
sudo sh -c 'echo "deb [arch=amd64] http://apt-mo.trafficmanager.net/repos/dotnet/ xenial main" > /etc/apt/sources.list.d/dotnetdev.list'
sudo apt-key adv --keyserver apt-mo.trafficmanager.net --recv-keys 417A0893
sudo apt-get update
Ubuntu 16.10
sudo sh -c 'echo "deb [arch=amd64] http://apt-mo.trafficmanager.net/repos/dotnet/ yakkety main" > /etc/apt/sources.list.d/dotnetdev.list'
sudo apt-key adv --keyserver apt-mo.trafficmanager.net --recv-keys 417A0893
sudo apt-get update
Debian 8
sudo sh -c 'echo "deb [arch=amd64] http://apt-mo.trafficmanager.net/repos/dotnet/ jessie main" > /etc/apt/sources.list.d/dotnetdev.list'
sudo apt-key adv --keyserver apt-mo.trafficmanager.net --recv-keys 417A0893
sudo 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 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.