Building from Source

If you are contributing code or you want to build from source then building from source is what you will want to do. Follow the steps below:

  1. To build our sources, you must be running either Windows 8 or Windows Server 2012. You will also need to install Visual Studio 2012. If you wish to rebuild the portable library version of System.Net.Http.Formatting, you should also install the Windows 8 Phone SDK.
  2. Make sure you have Git installed. In addition, you may want to install one of the Git helpers:
    • TortoiseGit is highly recommended, because it offers graphical log/tree views and diff/merge experience.
    • Posh-Git is highly recommended for PowerShell users.
    • Git Source Control Provider is an optional component that integrates git into Visual Studio.
  3. Using your preferred Git client clone our Git repo located at
    git clone https://git01.codeplex.com/aspnetwebstack.git
  4. Enable SkipStrongNames to allow you to run unit tests against the delay-signed binaries:
    build EnableSkipStrongNames
  5. To build and run the tests from a command prompt, run build.cmd** (found in the root directory). Note: As part of building you may need to obtain NuGet packages from the Outercurve Foundation NuGet public feed*.  
    build

See Runtime.sln in the root directory to open the solution in Visual Studio. For the portable library version of System.Net.Http.Formatting, see RuntimePortable.sln in the root directory.

* By running build, you will be initiating the download of other software packages from a NuGet-based feed that is owned by the Outercurve Foundation. You are responsible for locating, reading and complying with the license terms that accompany each such package. Each package is licensed to you by its owner. Microsoft is not responsible for, nor does it grant any licenses to, third-party packages.

** If you have installed the Windows Phone 8 SDK, you can also build the portable library of System.Net.Http.Formatting by running build UnitTests /p:BuildPortable=true to build and run unit tests or build Build /p:BuildPortable to only build without running tests.

 

Repository Tags and Version Numbers

The Git repository has multiple products in it, each with its own versioning history. To find the Git tag/branch for a particular product version, use the table below.

Git Tag Products MVC Web API Web Pages MVC and Web API Assembly Version  Web Pages Assembly Version File Version 
v2.0-rc VS 2012 RC v4 RC v1 RC v2 RC 4.0.0.0 2.0.0.0 x.0.20505.0
v2.0 VS 2012 v4 RTM v1 RTM v2 RTM 4.0.0.0 2.0.0.0 x.0.20710.0
v2.0.1 VS 2010 Update v4 RTM v1 RTM v2 RTM 4.0.0.0 2.0.0.0 x.0.20713.0
v2.0.2 WebMatrix v4 RTM v1 RTM v2 RTM 4.0.0.0 2.0.0.0 x.0.20715.0
v2.0.3 Lync v4 RTM v1 RTM v2 RTM 4.0.0.0 2.0.0.0 x.0.20918.0
v2.1-beta ASP.NET Fall 2012 Update BUILD Prerelease v4 Refresh Prerelease v1 Refresh Prerelease v2 Refresh Prerelease 4.0.0.0 2.0.0.0 x.0.21029.0
v2.1-rc ASP.NET and Web Tools 2012.2 RC
VS 2012 Update 2 RC
v4 2012.2 RC v1 2012.2 RC v2 2012.2 RC 4.0.0.0 2.0.0.0 0.3.0.0
v2.1 ASP.NET and Web Tools 2012.2
VS 2012 Update 2
v4 2012.2 Update RTM v1 2012.2 Update RTM v2 2012.2 Update RTM 4.0.0.0 2.0.0.0 x.0.20208.0
v3.0-beta1 VS 2013 Preview v5 Preview v2 Preview v3 Preview 5.0.0.0 3.0.0.0 x.0.10530.0
v3.0-beta2 VS 2013 Preview Refresh v5 Preview Refresh v2 Preview Refresh v3 Preview Refresh 5.0.0.0 3.0.0.0 x.0.10620.0
v3.0-rc VS 2013 RC v5 RC v2 RC v3 RC

5.0.0.0

3.0.0.0

x.0.10809.0

v3.0
v3-rtm (branch)
VS 2013 v5 RTM v2 RTM v3 RTM

5.0.0.0

3.0.0.0

x.0.11001.0

v3.1-rc ASP.NET MVC 5.1 RC/Web API 2.1 RC/Web Pages 3.1 RC v5.1 RC v2.2 RC v3.1 RC

5.1.0.0

3.0.0.0

x.1.11128.0

v3.1 ASP.NET MVC 5.1/Web API 2.1/Web Pages 3.1 v5.1 RTM v2.1 RTM v3.1 RTM

5.1.0.0

3.0.0.0

x.1.20110.0

v3.1.1 ASP.NET MVC 5.1.1/Web API 2.1.1/Web Pages 3.1.1 v5.1.1 RTM v2.1.1 RTM v3.1.1 RTM

5.1.0.0

3.0.0.0

x.1.20129.0

master (branch)   v5.2 Preview (in progress) v2.2 Preview (in progress) v3.2 Preview (in progress)

5.2.0.0

3.0.0.0

 

Last edited Feb 19 at 5:56 PM by davidmatson, version 33

Comments

vijayst Nov 1, 2013 at 4:38 AM 
The following post provides step by step instructions to debug asp.net mvc in your system: http://vijayt.com/Post/Setting-up-aspnet-mvc-for-debugging-in-your-system

jtu100 Oct 5, 2012 at 6:33 PM 
This seems to be the best information out there about debugging MVC 4 source code on VS2012 http://vibrantcode.com/2012/06/06/look-ma-no-gac/

jtu100 Oct 5, 2012 at 5:52 PM 
I am unable to debug MVC 4 on Win8/VS2012 with my own projects. Can someone write a guide? I am not knowledgeable enough to get it working.