Chrome Build Guide
author: Rich Joiner (joiner@cs.wisc.edu)
date: 2012-02-29

This describes how I set up and built Chrome on Windows 7, managing the 
repository in Cygwin and building in MS Visual Studio 2010 Ultimate. Other
environments are described in the documents that are linked to below ... I
suggest you read them carefully before starting anything (they are somewhat
non-chronological) to avoid wasting alot of time.

The main info page is at http://www.chromium.org/developers/how-tos.
I mainly worked off the Windows instructions found at
http://www.chromium.org/developers/how-tos/build-instructions-windows

If you want to manage the repository through Cygwin, you need to install
Subversion, Git and Python through the Cygwin installer. This will allow the
successful use of the depot_tools gclient (which seems to be a special Google
wrapper around SVN/Git). An initial attempt with a non-Cygwin Python
installation went awry. Also, make sure that Subversion is 1.7 or higher.

===========
You can download the Chrome source via the tarball bootstrap as described here:
http://www.chromium.org/developers/how-tos/get-the-code

Important note: don't use Cygwin's tar utility to extract the tarball! I
suggest 7-zip on Windows or tar is supposed to work fine on Linux.

However, I eventually eschewed this route in favor of a direct SVN checkout.
The subsequent steps should all be the same ... the tarball is just supposed to
save some download time.
===========

Get depot_tools as described here, and add the depot_tools directory to
your PATH environment variable:
http://www.chromium.org/developers/how-tos/install-depot-tools

Create a directory in which you want to house the repository. (If you used the
tarball, I think you want to run this in the directory right above "src".) 

From within the new directory, run the config command as follows to check out
the very latest source.
gclient config http://src.chromium.org/svn/trunk/src

Or use something like the following to get a specific version. 17.0.963.56 is
the latest stable version at the time of this writing. 
See http://omahaproxy.appspot.com/ for current status.
gclient config http://src.chromium.org/svn/releases/17.0.963.56

Run the following command, which effectively does an "svn update" on the
repository.
gclient sync --force

Install Microsoft Visual Studio 10 from the DreamSpark website (assuming you're
in the UW-Madison CS department). You should set the GYP_MSVS_VERSION
environment variable to "2010".

Install the DirectX SDK. See the following page.
http://msdn.microsoft.com/en-us/directx/default.aspx

Set up the Visual Studio projects to look for includes and libs in the 
DirectX directories. In MSVS 2010 Ultimate, the Property Manager can be 
opened via View > Other Windows > Property Manager.  Expand any of the 
projects and then any of the folders (e.g. Debug | Win32).  Double-click 
the top item, which is the user-specific property sheet. Select
VC++ Directories, and prepend the following to the Include Directories and
Library Directories values respectively.

$(DXSDK_DIR)\include;
$(DXSDK_DIR)\lib\x86;

Now try building the project and see what happens! If successful, the Chrome
executable should be found at src/build/[Debug or Release]/chrome.exe.