From: Rich Lander Date: Fri, 24 Apr 2015 23:28:04 +0000 (-0700) Subject: Update binary distribution instructions X-Git-Tag: accepted/tizen/base/20180629.140029~6788^2 X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=fb8b98718c7e92604309c55d5989bf568cc8c73e;p=platform%2Fupstream%2Fcoreclr.git Update binary distribution instructions --- diff --git a/Documentation/dnx-instructions.md b/Documentation/custom-dnx-instructions.md similarity index 100% rename from Documentation/dnx-instructions.md rename to Documentation/custom-dnx-instructions.md diff --git a/Documentation/get-dotnetcore-windows-dnvm.md b/Documentation/get-dotnetcore-windows-dnvm.md new file mode 100644 index 0000000..5819a5c --- /dev/null +++ b/Documentation/get-dotnetcore-windows-dnvm.md @@ -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 diff --git a/Documentation/get-coreclr-windows.md b/Documentation/get-dotnetcore-windows-nuget.md similarity index 91% rename from Documentation/get-coreclr-windows.md rename to Documentation/get-dotnetcore-windows-nuget.md index 60953a5..77ad203 100644 --- a/Documentation/get-coreclr-windows.md +++ b/Documentation/get-dotnetcore-windows-nuget.md @@ -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. diff --git a/README.md b/README.md index af3bfb5..818bbc2 100644 --- 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)
[DNVM](Documentation/get-dotnetcore-windows-dnvm.md) ||| Chat Room ---------