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 2013 Update 2. 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
  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*.  

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 x.0.20505.0
v2.0 VS 2012 v4 RTM v1 RTM v2 RTM x.0.20710.0
v2.0.1 VS 2010 Update v4 RTM v1 RTM v2 RTM x.0.20713.0
v2.0.2 WebMatrix v4 RTM v1 RTM v2 RTM x.0.20715.0
v2.0.3 Lync v4 RTM v1 RTM v2 RTM x.0.20918.0
v2.1-beta ASP.NET Fall 2012 Update BUILD Prerelease v4 Refresh Prerelease v1 Refresh Prerelease v2 Refresh Prerelease 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
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 x.0.20208.0
v3.0-beta1 VS 2013 Preview v5 Preview v2 Preview v3 Preview x.0.10530.0
v3.0-beta2 VS 2013 Preview Refresh v5 Preview Refresh v2 Preview Refresh v3 Preview Refresh x.0.10620.0
v3.0-rc VS 2013 RC v5 RC v2 RC v3 RC


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


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


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


v3.2 ASP.NET MVC 5.2/Web API 2.2/Web Pages 3.2 v5.2 RTM v2.2 RTM v3.2 RTM


v3.2.2-rc   v5.2.2 RC v5.2.2 RC v3.2.2 RC


v3.2.2   v5.2.2 RTM v5.2.2 RTM v3.2.2 RTM


master (branch) New work      




The following table describes the tags for OData product versions after 5.2. For versions prior to 5.2 the information is the same as for Web API, MVC, etc.

 Git Tag Products   OData v4  OData v3 OData assembly version  File version 
 odata-v5.3   Microsoft ASP.NET Web API 2.2 for OData v4.0 5.3.0 Microsoft ASP.NET Web API 2.2 for OData v1-3 5.3.0  5.3.20903.0

The following table describes the tags for Facebook product versions:

 Git Tag  Products  Facebook  Facebook assembly version  File version
 fbv1.0   Microsoft ASP.NET Facebook 1.0.0  1.0.20624.0
 fbv1.1-beta   Microsoft ASP.NET Facebook 1.1.0-beta  1.1.20908.0

Last edited Sep 17 at 12:53 AM by jacalvar, version 40


vijayst Nov 1, 2013 at 4:38 AM 
The following post provides step by step instructions to debug mvc 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

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.