.NET Core is a self-contained .NET runtime and framework that implements [ECMA 335](project-docs/dotnet-standards.md). It can be (and has been) ported to multiple architectures and platforms. It supports a variety of installation options, having no specific deployment requirements itself.
-Learn about .NET Core
-====================
+Getting Started
+===============
+- [Installing the .NET Core SDK](https://www.microsoft.com/net/core)
- [[WIP] Official .NET Core Docs](http://dotnet.github.io/docs/)
-Get .NET Core
-=============
-
-- [Get .NET Core DNX SDK on Windows](install/get-dotnetcore-dnx-windows.md)
-- [Get .NET Core DNX SDK on OS X](install/get-dotnetcore-dnx-osx.md)
-- [Get .NET Core DNX SDK on Linux](install/get-dotnetcore-dnx-linux.md)
-- [Get .NET Core (Raw) on Windows](install/get-dotnetcore-windows.md)
-
Project Docs
============
+++ /dev/null
-Get the .NET Core DNX SDK on Linux
-==================================
-
-These instructions will lead you through acquiring the .NET Core DNX SDK via the [.NET Version Manager (DNVM)](https://github.com/aspnet/dnvm) and running a "Hello World" demo on Linux. The instructions use a particular set of paths. You'll need to adjust if you want to use a different set.
-
-These instructions are for .NET Core console apps. If you want to try out ASP.NET 5 on top of .NET Core - which is a great idea - check out the [ASP.NET 5 instructions](https://github.com/aspnet/home).
-
-.NET Core NuGet packages and the .NET Core DNX SDKs are available on the [ASP.NET 'vnext' myget feed](https://www.myget.org/F/aspnetvnext), which you can more easily view on [gallery](https://www.myget.org/gallery/aspnetvnext) for the feed.
-
-You can also [build from source](../building/linux-instructions.md).
-
-Environment
-===========
-
-These instructions are written assuming the Ubuntu 14.04 LTS, since that's the distro the team uses. Pull Requests are welcome to address other environments as long as they don't break the ability to use Ubuntu 14.04 LTS.
-
-Packages
---------
-
-Install the `libunwind8`, `libssl-dev` and `unzip` packages:
-
- sudo apt-get install libunwind8 libssl-dev unzip
-
-You also need a latest version of Mono, which is required for DNU. This is a temporary requirement.
-
- sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 3FA7E0328081BFF6A14DA29AA6A19B38D3D831EF
- echo "deb http://download.mono-project.com/repo/debian wheezy main" | sudo tee /etc/apt/sources.list.d/mono-xamarin.list
- sudo apt-get update
- sudo apt-get install mono-complete
-
-Certificates
-------------
-
-You need to import trusted root certificates in order to restore NuGet packages. You can do that with the `mozroots` tool.
-
- mozroots --import --sync
-
-Installing DNVM
-===============
-
-You need DNVM to acquire a (or multiple) .NET Execution Environment (DNX) SDKs. DNVM is simply a script, which doesn't depend on .NET.
-
- curl -sSL https://raw.githubusercontent.com/aspnet/Home/dev/dnvminstall.sh | DNX_BRANCH=dev sh && source ~/.dnx/dnvm/dnvm.sh
-
-You can see the currently installed DNX versions with `dnvm list`, which will display an empty set of installed runtimes.
-
- dnvm list
-
-Installing the .NET Core DNX SDK
-================================
-
-You first need to acquire the Mono DNX. It doesn't include Mono, but is needed to use the DNX tools on top of Mono. In particular, the DNU command is not yet supported on .NET Core, requiring us to use Mono for this purpose (until DNU runs on .NET Core). Mono is the default DNX, do you can acquire it via `dnvm upgrade`.
-
- dnvm upgrade -u
-
-Next, acquire the latest .NET Core DNX SDK.
-
- dnvm install latest -r coreclr -u
-
-You can see the currently installed DNX versions with `dnvm list` (your display may vary as new versions of the DNX are published):
-
- dnvm list
-
-```
-Active Version Runtime Architecture OperatingSystem Alias
------- ------- ------- ------------ --------------- -----
- * 1.0.0-beta8-15613 coreclr x64 linux
- 1.0.0-beta8-15613 mono linux/osx default
-```
-
-Write your App
-==============
-
-You need a Hello World application to run. You can write your own, if you'd like. Here's a very simple one:
-
-```csharp
-using System;
-
-public class Program
-{
- public static void Main (string[] args)
- {
- Console.WriteLine("Hello, Linux");
- Console.WriteLine("Love from CoreCLR.");
- }
-}
-```
-
-Some people on the .NET Core team are partial to a demo console app on corefxlab repo which will print a picture for you. Download the [corefxlab demo](https://raw.githubusercontent.com/dotnet/corefxlab/master/demos/CoreClrConsoleApplications/HelloWorld/HelloWorld.cs) to the demo directory.
-
-You need a `project.json` that matches your app. Use this one. It will work for both of the apps provided/referenced above. Save the project.json beside your app.
-
-```
-{
- "version": "1.0.0-*",
- "dependencies": {
- },
- "frameworks" : {
- "dnx451" : { },
- "dnxcore50" : {
- "dependencies": {
- "System.Console": "4.0.0-beta-*"
- }
- }
- }
-}
-```
-
-Run your App
-============
-
-You need to restore packages for your app, based on your project.json, with `dnu restore`. You will need to run this command under the Mono DNX. Make sure that you are using that one.
-
- dnvm use 1.0.0-beta8-15613 -r mono
- dnu restore
-
-You can run your app with .NET Core, although make sure to switch to that DNX.
-
- dnvm use 1.0.0-beta8-15613 -r coreclr
- dnx run
-
- Hello, Linux
- Love from CoreCLR.
+++ /dev/null
-Get the .NET Core DNX SDK on OS X
-=================================
-
-These instructions will lead you through acquiring the .NET Core DNX SDK via the [.NET Version Manager (DNVM)](https://github.com/aspnet/dnvm) and running a "Hello World" demo on OS X. The instructions use a particular set of paths. You'll need to adjust if you want to use a different set.
-
-These instructions are for .NET Core console apps. If you want to try out ASP.NET 5 on top of .NET Core - which is a great idea - check out the [ASP.NET 5 instructions](https://github.com/aspnet/home).
-
-.NET Core NuGet packages and the .NET Core DNX SDKs are available on the [ASP.NET 'vnext' myget feed](https://www.myget.org/F/aspnetvnext), which you can more easily view on [gallery](https://www.myget.org/gallery/aspnetvnext) for the feed.
-
-You can also [build from source](../building/osx-instructions.md).
-
-Installing DNVM
-===============
-
-You need DNVM to acquire a (or multiple) .NET Execution Environment (DNX). DNVM is simply a script, which doesn't depend on .NET. On OS X the best way to get DNVM is to use [Homebrew](http://www.brew.sh). If you don't have Homebrew installed then follow the [Homebrew installation instructions](http://www.brew.sh). Once you have Homebrew then run the following commands:
-
- brew tap aspnet/dnx
- brew update
- brew install dnvm
-
-You will likely need to register the dnvm command:
-
- source dnvm.sh
-
-Installing the .NET Core DNX SDK
-================================
-
-You first need to acquire the Mono DNX. It includes a specfic version of Mono, and is needed to use the DNX tools that are not yet supported on .NET Core. Mono is the default DNX, so you can acquire it via `dnvm upgrade`.
-
- dnvm upgrade -u
-
-Next, acquire the latest .NET Core DNX SDK.
-
- dnvm install latest -r coreclr -u
-
-You can see the currently installed DNX versions with `dnvm list` (your display may vary as new versions of the DNX are published):
-
- dnvm list
-
-```
-Active Version Runtime Arch Location Alias
------- ------- ------- ---- -------- -----
- * 1.0.0-beta7-12364 coreclr x64 ~/.dnx/runtimes
- 1.0.0-beta7-12364 mono ~/.dnx/runtimes default
-```
-
-Write your App
-==============
-
-You need a Hello World application to run. You can write your own, if you'd like. Here's a very simple one:
-
-```csharp
-using System;
-
-public class Program
-{
- public static void Main (string[] args)
- {
- Console.WriteLine("Hello, OS X");
- Console.WriteLine("Love from CoreCLR.");
- }
-}
-```
-
-Some people on the .NET Core team are partial to a demo console app on corefxlab repo which will print a picture for you. Download the [corefxlab demo](https://raw.githubusercontent.com/dotnet/corefxlab/master/demos/CoreClrConsoleApplications/HelloWorld/HelloWorld.cs) to the demo directory.
-
-You need a `project.json` that matches your app. Use this one. It will work for both of the apps provided/referenced above. Save the project.json beside your app.
-
-```
-{
- "version": "1.0.0-*",
- "dependencies": {
- },
- "frameworks" : {
- "dnx451" : { },
- "dnxcore50" : {
- "dependencies": {
- "System.Console": "4.0.0-beta-*"
- }
- }
- }
-}
-```
-
-Run your App
-============
-
-You need to restore packages for your app, based on your project.json, with `dnu restore`. You will need to run this command under the Mono DNX. Make sure that you are using that one.
-
- dnvm use 1.0.0-beta7-12364 -r mono
- dnu restore
-
-You can run your app with .NET Core, although make sure to switch to that DNX.
-
- dnvm use 1.0.0-beta7-12364 -r coreclr
- dnx run
-
- Hello, OSX
- Love from CoreCLR.
+++ /dev/null
-Get the .NET Core DNX SDK on Windows
-====================================
-
-These instructions will lead you through acquiring the .NET Core DNX SDK via the [.NET Version Manager (DNVM)](https://github.com/aspnet/dnvm) and running a "Hello World" demo on Windows. The instructions use a particular set of paths. You'll need to adjust if you want to use a different set.
-
-These instructions are for .NET Core console apps. If you want to try out ASP.NET 5 on top of .NET Core - which is a great idea - check out the [ASP.NET 5 instructions](https://github.com/aspnet/home).
-
-.NET Core NuGet packages and the .NET Core DNX SDKs are available on the [ASP.NET 'vnext' myget feed](https://www.myget.org/F/aspnetvnext), which you can more easily view on [gallery](https://www.myget.org/gallery/aspnetvnext) for the feed.
-
-You can also acquire .NET Core directly via [NuGet restore](get-dotnetcore-windows.md) or [build from source](../building/windows-instructions.md).
-
-Installing DNVM
-===============
-
-You need DNVM as a starting point. DNVM enables you to acquire a (or multiple) .NET Execution Environment (DNX). DNVM is simply a script, which doesn't depend on .NET. You can install it via a PowerShell command. You can find alternate DNVM install instructions at the [ASP.NET Home repo](https://github.com/aspnet/home).
-
- C:\coreclr-demo> @powershell -NoProfile -ExecutionPolicy unrestricted -Command "&{$Branch='dev';iex ((new-object net.webclient).DownloadString('https://raw.githubusercontent.com/aspnet/Home/dev/dnvminstall.ps1'))}"
-
-You must close your command-prompt and start a new one in order for the user-wide environment variables to take effect.
-
-You can see the currently installed DNX versions with `dnvm list`, which will display an empty set of installed runtimes.
-
- C:\coreclr-demo> dnvm list
-
-Installing a .NET Core DNX
-==========================
-
-It's easy to install the latest .NET Core-based DNX, using the `dnvm install` command. The `-u` (or `-Unstable`) parameter installs latest unstable version.
-
- C:\coreclr-demo> dnvm install -r coreclr latest -u
-
-This will install the 32-bit version of .NET Core. If you want the 64-bit version, you can specify processor architecture:
-
- C:\coreclr-demo> dnvm install -r coreclr -arch x64 latest -u
-
-You can see the currently installed DNX versions with `dnvm list` (your display may vary as new versions of the DNX are published):
-
- C:\coreclr-demo>dnvm list
-
-```
-Active Version Runtime Architecture Location Alias
------- ------- ------- ------------ -------- -----
- 1.0.0-beta7-12364 coreclr x86 C:\Users\rlander\.dnx\runtimes
- 1.0.0-beta7-12364 coreclr x64 C:\Users\rlander\.dnx\runtimes
-```
-
-You can choose which of these DNXs you want to use with `dnvm use`, with similar arguments.
-
-```
-C:\coreclr-demo>dnvm use -r coreclr -arch x86 1.0.0-beta7-12364
-Adding C:\Users\rlander\.dnx\runtimes\dnx-coreclr-win-x86.1.0.0-beta7-12364\bin
-to process PATH
-
-C:\coreclr-demo>dnvm list
-
-Active Version Runtime Architecture Location Alias
------- ------- ------- ------------ -------- -----
- * 1.0.0-beta7-12364 coreclr x86 C:\Users\rlander\.dnx\runtimes
- 1.0.0-beta7-12364 coreclr x64 C:\Users\rlander\.dnx\runtimes
-```
-
-Write your App
-==============
-
-You need a Hello World application to run. You can write your own, if you'd like. Here's a very simple one:
-
-```csharp
-using System;
-
-public class Program
-{
- public static void Main (string[] args)
- {
- Console.WriteLine("Hello, Windows");
- Console.WriteLine("Love from CoreCLR.");
- }
-}
-```
-
-Some people on the .NET Core team are partial to a demo console app on corefxlab repo which will print a picture for you. Download the [corefxlab demo](https://raw.githubusercontent.com/dotnet/corefxlab/master/demos/CoreClrConsoleApplications/HelloWorld/HelloWorld.cs) to `C:\coreclr-demo`.
-
-You need a `project.json` that matches your app. Use this one. It will work for both of the apps provided/referenced above. Save the project.json beside your app.
-
-```
-{
- "version": "1.0.0-*",
- "dependencies": {
- },
- "frameworks" : {
- "dnx451" : { },
- "dnxcore50" : {
- "dependencies": {
- "System.Console": "4.0.0-beta-*"
- }
- }
- }
-}
-```
-
-Run your App
-============
-
-You need to restore packages for your app, based on your project.json, with `dnu restore`.
-
- C:\coreclr-demo> dnu restore
-
-You can run your app with the DNX command.
-
- C:\coreclr-demo> dnx run
- Hello, Windows
- Love from CoreCLR.
+++ /dev/null
-Get .NET Core on Windows - Raw Experience
-=========================================
-
-These instructions will lead you through acquiring .NET Core directly via NuGet restore and running a "Hello World" demo on Windows. The instructions use a particular set of directory paths. You'll need to adjust if you want to use a different set.
-
-These instructions are for .NET Core console apps. If you want to try out ASP.NET 5 on top of .NET Core - which is a great idea - check out the [ASP.NET 5 instructions](https://github.com/aspnet/home).
-
-.NET Core NuGet packages are available on the [.NET Core myget feed](https://www.myget.org/F/dotnet-core), which you can more easily view on [gallery](https://www.myget.org/gallery/dotnet-core) for the feed.
-
-The preferred approach to acquire .NET Core is via the [.NET Core DNX SDK](get-dotnetcore-dnx-windows.md). It's the easiest approach. Alternatively, you can [build from source](../building/windows-instructions.md). This "raw" approach falls between the two in difficulty.
-
-NuGet Restore Packages
-======================
-
-Given that NuGet is the .NET Core distribution mechanism, you need a packages.config to restore the packages. The following packages.config is the most minimal one you can have for console apps. You will need to add packages if your app needs it Save this XML to `c:\coreclr-demo\packages\packages.config`.
-
-```
-<?xml version="1.0" encoding="utf-8"?>
-<packages>
- <package id="System.Console" version="4.0.0-beta-22713" />
- <package id="System.Diagnostics.Contracts" version="4.0.0-beta-22713" />
- <package id="System.Diagnostics.Debug" version="4.0.10-beta-22713" />
- <package id="System.Diagnostics.Tools" version="4.0.0-beta-22713" />
- <package id="System.Globalization" version="4.0.10-beta-22713" />
- <package id="System.IO" version="4.0.10-beta-22713" />
- <package id="System.IO.FileSystem.Primitives" version="4.0.0-beta-22713" />
- <package id="System.Reflection" version="4.0.10-beta-22713" />
- <package id="System.Runtime" version="4.0.20-beta-22713" />
- <package id="System.Runtime.Extensions" version="4.0.10-beta-22713" />
- <package id="System.Runtime.InteropServices" version="4.0.20-beta-22713" />
- <package id="System.Text.Encoding" version="4.0.10-beta-22713" />
- <package id="System.Text.Encoding.Extensions" version="4.0.10-beta-22713" />
- <package id="System.Threading" version="4.0.10-beta-22713" />
- <package id="System.Threading.Tasks" version="4.0.10-beta-22713" />
- <package id="Microsoft.NETCore.Runtime.CoreCLR.ConsoleHost-x64" version="1.0.0-beta-22819" />
- <package id="Microsoft.NETCore.Runtime.CoreCLR-x64" version="1.0.0-beta-22819"/>
- <package id="Microsoft.NETCore.Runtime.ApiSets-x64" version="1.0.0-beta-22819" /><!-- only required on Windows 7 -->
-</packages>
-```
-
-You will need to update the version numbers to acquire later versions of the NuGet packages. If you do, you'll need to update the copy commands later in the instructions to reflect these changes. NuGet supports wildcard versions, such as `version="4.0.0-beta-*`, which can be helpful.
-
-Download the [NuGet client](https://nuget.org/nuget.exe) if you don't already have it in your path. You can grab it from: https://nuget.org/nuget.exe. Save it to `c:\coreclr-demo`.
-
-You need to restore the packages to the packages directory.
-
- C:\coreclr-demo> nuget restore packages\packages.config -Source https://www.myget.org/F/dotnet-core/ -PackagesDirectory packages
-
-Write your App
-==============
-
-You need a Hello World application to run. You can write your own, if you'd like. Here's a very simple one:
-
-```csharp
-using System;
-
-public class Program
-{
- public static void Main (string[] args)
- {
- Console.WriteLine("Hello, Windows");
- Console.WriteLine("Love from CoreCLR.");
- }
-}
-```
-
-**Another Option:** Some people on the .NET Core team are partial to a demo console app on corefxlab repo which will print a picture for you. To try it, download [corefxlab demo's HelloWorld.cs](https://raw.githubusercontent.com/dotnet/corefxlab/master/demos/CoreClrConsoleApplications/HelloWorld/HelloWorld.cs) to `C:\coreclr-demo`.
-
-Compile your App
-================
-
-You need to build your app with csc, the .NET Framework C# compiler. It may be easier to do this step within the "Developer Command Prompt for VS2013", if csc is not in your path. You need to pass references to the reference assemblies you restored using NuGet in order to compile the app against the .NET Core surface area:
-
- C:\coreclr-demo> md app
-
- C:\coreclr-demo> csc /nostdlib /noconfig /r:packages\System.Runtime.4.0.20-beta-22713\ref\any\System.Runtime.dll /r:packages\System.Console.4.0.0-beta-22713\ref\any\System.Console.dll /out:app/HelloWorld.dll HelloWorld.cs
-
-It might seem odd, but this command compiles your app to a DLL. That's intended.
-
-Prepare the demo
-================
-
-You need to copy the NuGet package assemblies over to the app folder. You need to run a few commands, including a little batch magic.
-
- C:\coreclr-demo> for /r packages %k in (*.dll) do echo "%k" | findstr "\lib\any\ \lib\netcore50\ \lib\any~win\\" && copy /Y "%k" app
-
- C:\coreclr-demo> copy packages\Microsoft.NETCore.Runtime.CoreCLR.ConsoleHost-x64.1.0.0-beta-22819\native\win\x64\CoreConsole.exe app\HelloWorld.exe
-
-This last step might be a bit surprising, copying `CoreConsole.exe` to MyApp.exe, in this case `HelloWorld.exe`. This is closely related to compiling the app, in the instructions above, to MyApp.dll, in this case to `HelloWorld.dll`.
-
-We've grown very fond of creating and using managed EXEs that don't require a separate launcher with the .NET Framework on Windows. We wanted the same experience for .NET Core. To enable the experience, we created a launcher that expects a managed assembly of the same name, compiled with a static main method. As a case in point, if you run `CoreConsole.exe` without renaming it, it will expect a `CoreConsole.dll`. The renaming step, which you see above, needs to match the main assembly, compiled as a DLL, and you get an experience that feels launcher-less.
-
-Lastly, if you're a Windows 7 user, you'll need to copy over some API DLLS:
-
- C:\coreclr-demo> copy packages\Microsoft.NETCore.Runtime.ApiSets-x64.1.0.0-beta-22819\native\x64\*.dll app
-
-Run the demo
-============
-
-You're ready to run Hello World!
-
- C:\coreclr-demo> app\HelloWorld.exe
- Hello, Windows
- Love from CoreCLR.
-
-Thanks for trying out CoreCLR. Feel free to try a more interesting demo.
projects / platform / upstream / dotnet / runtime.git / commitdiff