Music store application

###Getting Started

The first thing we need to do is setup the tools required to build and run an application.

• If you already have kvm installed on the machine ignore the steps below.
• Clone UpdateToLatest branch from [Home] (https://github.com/aspnet/Home) repository
• On the command line, cd to Home repository and execute kvm setup
• This command will download the latest version of the SDK and put it on your path so that you can run the rest of the commands in the readme. If you want to know more about what this is doing then you can read the KVM page of the wiki.
• On the command line execute kvm install 0.1-alpha-build-0421
• This command will install Desktop flavor(x86) of KRE build 0421 in your user profile
• Clone MusicStore repository, if you have not already

Run the application:

1. Open a command prompt and cd \src\<AppFolder>\
2. Run kpm restore to restore all the necessary packages and generate project files Note: kpm restore currently works only on Desktop flavor. If you intend to use Core CLR, you should get Desktop flavor, execute kpm restore and then switch to Core CLR
3. [Helios]: 4. Helios.cmd to launch the app on IISExpress (Application started at URL http://localhost:5001/).
4. [SelfHost]: 5. Run k web (Application started at URL http://localhost:5002/)
5. [CustomHost]: 6. Run k run (This hosts the app in a console application - Application started at URL http://localhost:5003/)

Switching between Desktop CLR and CoreCLR:

By default the app runs on desktop CLR. To switch to run the app on CoreCLR follow the steps below

• On the command line, execute kvm install 0.1-alpha-build-0421 -svrc50
• This command will install core clr flavor of KRE build 0421 and set runtime to core clr 0421 build.
• If you want to run on IIS/IISExpress against core clr, open k.ini and update KRE_FLAVOR to CORECLR and follow steps for running the application from 'Run the application' section
• If you want to run on SelfHost against core clr, follow steps for running the application from 'Run the application' section

Adding a new package:

1. Edit the project.json to include the package you want to install
2. Do a kpm restore - This will restore the package and regenerate your csproj files to get intellisense for the installed packages.

Work against the latest build:

1. Run Clean.cmd - This will clear all the packages and any temporary files generated
2. Continue the topic "Run the application"

Work against LKG Build:

1. Everytime you do a kpm restore you will get the latest packages of all the included packages. If you would like to go back to an LKG build checkout the LKG.json file in the MusicStore folder.
2. This is a captured snapshot of build numbers which worked for this application. This LKG will be captured once in a while.

Note:

1. Application is started on different ports on different hosts. To change the port or URL modify Helios.cmd or project.json commands section in case of self-host and customhost.
2. Use Visual studio only for editing & intellisense. Don't try to build or run the app from Visual studio.