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 runningbuild UnitTests /p:BuildPortable=true to build and run unit tests orbuild Build /p:BuildPortable to only build without running tests.