Update binary distribution instructions
authorRich Lander <rich@lander.ca>
Fri, 24 Apr 2015 23:28:04 +0000 (16:28 -0700)
committerRichard Lander <rlander@microsoft.com>
Sat, 25 Apr 2015 05:17:29 +0000 (22:17 -0700)
Documentation/custom-dnx-instructions.md [moved from Documentation/dnx-instructions.md with 100% similarity]
Documentation/get-dotnetcore-windows-dnvm.md [new file with mode: 0644]
Documentation/get-dotnetcore-windows-nuget.md [moved from Documentation/get-coreclr-windows.md with 91% similarity]
README.md

diff --git a/Documentation/get-dotnetcore-windows-dnvm.md b/Documentation/get-dotnetcore-windows-dnvm.md
new file mode 100644 (file)
index 0000000..5819a5c
--- /dev/null
@@ -0,0 +1,107 @@
+Get .NET Core on Windows with DNVM
+==================================
+
+These instructions will lead you through acquiring .NET Core 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 is distributed as NuGet packages. You can acquire it via [NuGet restore](get-coreclr-windows-nuget.md) or the .NET Version Manager (these instructions). Alternatively, you can [build from source](windows-instructions.md). 
+
+You can see the [CoreCLR myget feed](https://www.myget.org/F/dotnet-core) @ the [dotnet-core gallery](https://www.myget.org/gallery/dotnet-core) page. These packages are not yet published to NuGet.org, but that will change soon.
+
+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 itructions at the [ASP.NET Home repo](https://github.com/aspnet/home).
+
+       @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. 
+
+       C:\coreclr-demo>dnvm install -r coreclr latest
+
+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
+
+You can see the currently installed DNX versions with `dnvm list`.
+
+       C:\coreclr-demo>dnvm list
+
+       Active Version           Runtime Architecture Location
+       ------ -------           ------- ------------ --------
+         *    1.0.0-beta5-11596 coreclr x64          C:\Users\rlander\.dnx\runtimes
+              1.0.0-beta5-11596 coreclr x86          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-beta5-11596
+       Adding C:\Users\rlander\.dnx\runtimes\dnx-coreclr-win-x86.1.0.0-beta5-11596\bin
+       to process PATH
+
+       C:\coreclr-demo>dnvm list
+
+       Active Version           Runtime Architecture Location
+       ------ -------           ------- ------------ --------
+              1.0.0-beta5-11596 coreclr x64          C:\Users\rlander\.dnx\runtimes
+         *    1.0.0-beta5-11596 coreclr x86          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.
\ No newline at end of file
similarity index 91%
rename from Documentation/get-coreclr-windows.md
rename to Documentation/get-dotnetcore-windows-nuget.md
index 60953a5..77ad203 100644 (file)
@@ -1,9 +1,9 @@
-Get CoreCLR on Windows
-======================
+Get .NET Core on Windows with NuGet
+===================================
 
-These instructions will lead you through acquiring CoreCLR 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 will lead you through acquiring .NET Core via NuGet 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.
 
-CoreCLR is distributed as NuGet packages. There is no installer or other distribution mechanism, other than [building from source](windows-instructions.md). You acquire CoreCLR via the normal NuGet restore experience.
+.NET Core is distributed as NuGet packages. You can acquire it via NuGet restore (these instructions) or the [.NET Version Manager](get-coreclr-windows-dnvm.md). Alternatively, you can [build from source](windows-instructions.md). 
 
 You can see the [CoreCLR myget feed](https://www.myget.org/F/dotnet-core) @ the [dotnet-core gallery](https://www.myget.org/gallery/dotnet-core) page. These packages are not yet published to NuGet.org, but that will change soon.
 
index af3bfb5..818bbc2 100644 (file)
--- a/README.md
+++ b/README.md
@@ -15,9 +15,9 @@ Get CoreCLR
 -----------
 
 |                     |Linux   |Windows |Mac OS X |FreeBSD  |
-|---------------------|:------:|:------:|:-------:|:-------:|
+|---------------------|--------|--------|---------|---------|
 |Build from **Source**| [Instructions](Documentation/linux-instructions.md) | [Instructions](Documentation/windows-instructions.md) | [Instructions](Documentation/osx-instructions.md) | [Instructions](Documentation/freebsd-instructions.md) |
-|Get **Binaries**     | |[Instructions](Documentation/get-coreclr-windows.md)|||
+|Get **Binaries**     | |[NuGet](Documentation/get-dotnetcore-windows-nuget.md) <br> [DNVM](Documentation/get-dotnetcore-windows-dnvm.md) |||
 
 Chat Room
 ---------