You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+23-24Lines changed: 23 additions & 24 deletions
Original file line number
Diff line number
Diff line change
@@ -1,10 +1,10 @@
1
-
# ASP.NET vNext Home
1
+
# ASP.NET 5 Home
2
2
Latest dev version: [](https://www.myget.org/gallery/aspnetvnext)<br>
The Home repository is the starting point for people to learn about ASP.NET vNext. This repo contains samples and [documentation](https://github.com/aspnet/Home/wiki) to help folks get started and learn more about what's coming in ASP.NET vNext.
5
+
The Home repository is the starting point for people to learn about ASP.NET 5. This repo contains samples and [documentation](https://github.com/aspnet/Home/wiki) to help folks get started and learn more about what's coming in ASP.NET 5.
6
6
7
-
ASP.NET vNext is being actively developed by the ASP.NET team assigned to the Microsoft Open Tech Hub and in collaboration with a community of open source developers. Together we are dedicated to creating the best possible platform for web development.
7
+
ASP.NET 5 is being actively developed by the ASP.NET team assigned to the Microsoft Open Tech Hub and in collaboration with a community of open source developers. Together we are dedicated to creating the best possible platform for web development.
8
8
9
9
The samples provided in this repo are designed to show some of the features of the new framework and to provide a starting point for further exploration. All the component packages are available on NuGet. To try out the latest bits under development switch to the dev branch of the Home repo and use the dev feed in NuGet.config (https://www.myget.org/F/aspnetvnext).
10
10
@@ -35,56 +35,55 @@ The easiest way to get started with ASP.NET vNext is to try out the latest previ
35
35
36
36
That said, you can also try out ASP.NET vNext with just a command-prompt and a text editor. The following instructions will walk you through getting your dev environment setup.
37
37
38
-
### Install the K Version Manager (KVM)
38
+
### Install the .NET Version Manager (DNVM)
39
39
40
-
The first thing we need to do is setup the tools required to build and run an application. We will start out by getting the [K Version Manager (KVM)](https://github.com/aspnet/Home/wiki/version-manager). We use the K Version Manager to install different versions of the ASP.NET vNext runtime and switch between them.
40
+
The first thing we need to do is setup the tools required to build and run an application. We will start out by getting the [.NET Version Manager (DNVM)](https://github.com/aspnet/Home/wiki/version-manager). We use the .NET Version Manager to install different versions of the ASP.NET vNext runtime and switch between them.
41
41
42
42
#### Windows
43
-
To install KVM on Windows run the following command, which will download and run a script that installs KVM for the current user (requires admin privileges for Powershell). This will use the currently released version of `kvm` (from the `release` branch of this repo).
43
+
To install DNVM on Windows run the following command, which will download and run a script that installs DNVM for the current user (requires admin privileges for Powershell). This will use the currently in-development version of `dnvm` (from the `dev` branch of this repo).
After the script has run open a new command prompt to start using KVM.
55
+
After the script has run open a new command prompt to start using DNVM.
57
56
58
57
#### OS X:
59
58
60
-
To install KVM and the correct version of Mono on OS X using [Homebrew](http://brew.sh) follow the following steps:
59
+
To install DNVM and the correct version of Mono on OS X using [Homebrew](http://brew.sh) follow the following steps:
61
60
62
61
* Install [Homebrew](http://brew.sh) if it is not already installed.
63
-
* Run command `brew tap aspnet/k` to tap the ASP.NET vNext related git repositories. If you had already tapped the repo for previous releases, run `brew untap aspnet/k` to delete the old commands and tap again to get the updated brew scripts.
64
-
* Run command `brew install kvm` to install KVM. This also automatically install the latest KRE package from https://www.nuget.org/api/v2 feed.
62
+
* Run command `brew tap aspnet/k` to tap the ASP.NET 5 related git repositories. If you had already tapped the repo for previous releases, run `brew untap aspnet/k` to delete the old commands and tap again to get the updated brew scripts.
63
+
* Run command `brew install kvm` to install DNVM. This also automatically install the latest KRE package from https://www.nuget.org/api/v2 feed.
65
64
* Run command `source kvm.sh` on your terminal if your terminal cannot understand kvm.
66
65
67
66
#### Linux:
68
67
69
-
Installing KVM requires `curl`. Do verify if that is installed on the machine. Next install KVM on Linux run the following command:
68
+
Installing DNVM requires `curl`. Do verify if that is installed on the machine. Next install DNVM on Linux run the following command:
70
69
71
70
```
72
-
curl -sSL https://raw.githubusercontent.com/aspnet/Home/release/kvminstall.sh | sh && source ~/.k/kvm/kvm.sh
71
+
curl -sSL https://raw.githubusercontent.com/aspnet/Home/dev/dnvminstall.sh | sh && source ~/.k/dnvm/dnvm.sh
73
72
```
74
73
75
-
If you want to run on the bleeding edge and install the latest development version of KVM, use this command:
74
+
If you want to run on the bleeding edge and install the latest development version of DNVM, use this command:
76
75
77
76
```
78
-
curl -sSL https://raw.githubusercontent.com/aspnet/Home/release/kvminstall.sh | KVM_BRANCH=dev sh && source ~/.k/kvm/kvm.sh
77
+
curl -sSL https://raw.githubusercontent.com/aspnet/Home/dev/dnvminstall.sh | KVM_BRANCH=dev sh && source ~/.k/dnvm/dnvm.sh
79
78
```
80
79
81
80
Note that on Linux you need to also install [Mono](http://mono-project.com) 3.4.1 or later.
82
81
83
-
### Install the K Runtime Environment (KRE)
82
+
### Install the .NET Execution Environment (DNX)
84
83
85
-
Now that you have KVM setup you can install the latest version of the runtime by running the following command: ```kvm upgrade```
84
+
Now that you have DNVM setup you can install the latest version of the runtime by running the following command: ```dnvm upgrade```
86
85
87
-
This command will download the specified version of the K Runtime Environment (KRE), and put it on your user profile ready to use. You are now ready to start using ASP.NET vNext!
86
+
This command will download the specified version of the .NET Execution Environment (KRE), and put it on your user profile ready to use. You are now ready to start using ASP.NET 5!
88
87
89
88
## Samples
90
89
@@ -93,7 +92,7 @@ The samples in this repo are basic starting points for you to experiment with.
93
92
+[ConsoleApp](https://github.com/aspnet/Home/tree/release/samples/ConsoleApp). This is just basic console app if you want to use it as a starting point.
94
93
+[HelloWeb](https://github.com/aspnet/Home/tree/release/samples/HelloWeb). This is a minimal startup class that shows welcome page and static file middleware. This is mostly for you to run through the steps in the readme and make sure you have everything setup and working correctly.
95
94
+[HelloMvc](https://github.com/aspnet/Home/tree/release/samples/HelloMvc). This sample is a basic MVC app. It is not designed to show all the functionality of the new web stack, but to give you a starting point to play with features.
96
-
+[MVC Music Store](https://github.com/aspnet/MusicStore) and [BugTracker](https://github.com/aspnet/BugTracker) are application samples that are both being ported to ASP.NET vNext. Each of these samples have their own separate repositories that you can look at.
95
+
+[MVC Music Store](https://github.com/aspnet/MusicStore) and [BugTracker](https://github.com/aspnet/BugTracker) are application samples that are both being ported to ASP.NET 5. Each of these samples have their own separate repositories that you can look at.
97
96
98
97
### Running the samples
99
98
@@ -109,9 +108,9 @@ The samples in this repo are basic starting points for you to experiment with.
109
108
110
109
### Switching to Core CLR
111
110
112
-
By default when running ASP.NET vNext applications on the Windows platform you are running on the full .NET Framework. You can switch to use the new Cloud Optimized runtime, or Core CLR, using the KVM command.
111
+
By default when running ASP.NET 5 applications on the Windows platform you are running on the full .NET Framework. You can switch to use the new Cloud Optimized runtime, or Core CLR, using the DNVM command.
113
112
114
-
1. Run ```kvm upgrade -runtime CoreCLR``` This command gets the latest Core CLR version of the k runtime and sets it as your default. The `-runtime CoreCLR` switch tells it to use Core CLR. You can use `-r CLR` to target desktop again.
113
+
1. Run ```dnvm upgrade -runtime CoreCLR``` This command gets the latest Core CLR version of the k runtime and sets it as your default. The `-runtime CoreCLR` switch tells it to use Core CLR. You can use `-r CLR` to target desktop again.
115
114
2. Run ```k web``` to run on WebListener.
116
115
3. The first line of your output should say "Loaded Module: klr.core45.dll" instead of "Loaded Module: klr.net45.dll"
117
116
4. The HelloWeb app should work the same as when running on the full desktop .NET Framework but now as a fully self-contained app with true side-by-side versioning support.
0 commit comments