Google Chromium开发文档-初级入门指南

Google Chrome开源版本chromium的编译构建指南，此译文为编译构建指南的一部分，初级入门指南，主要为windows平台下Visual Studio的编译过程指导

如果你是很认真的想学习Chromium是如何工作的，那么此文档就是专为你准备的。你将得到Chromium的代码然后编译它。然后你将使用Visual Studio 2005debugger调试它，看它是怎样运行的，更深入点，你会知道它是如何处理来自用户的操作的。

提示：此文档是提供给Windows系统开发员和测试员的，并告诉他们它是如何运行代码的，如果你还没有设置好编译环境，你可以查阅"文档"页，如果你用的系统不是Windows,请查阅为Mac和Linux(我翻译的另一篇文章,构建linux版本的chrome)用户准备的编译指南.

获取你需要的软件
这节将告诉你如何设置你的Windows系统的编译环境，如果你遇到了问题或想了解更多信息，请查阅"编译指南(Windows版)"

满足前提条件的软件
首先，你的计算机必需安装了以下软件：
    *Windows XP(SP2或更高版本) 或 Windows Vista
    *Microsoft Visual Studio 2005(8.0)

附加软件(免费)下载
Visual Studio安装后，你需要下载并安装许多的相关软件
   1.下载并安装Microsoft Visual Studio 2005 Service Pack 1.
     视你的计算机具体情况，安装可能要花费一个小时的时间，并且安装后需要重新启动计算机。
   
   2.下载并安装Microsoft Windows SDK。
     安装完毕后需要重新启动计算机，可以不安装文档和代码示例，这样可以减少硬盘空间。

     提示：虽然SDK说自己只能用在Vista上，其实XP和Vista两个系统平台都可以使用，

     如果你已经有Microsoft 2008 SDk了，那么你就不需要下载一个新的了。

   3.整合SDK和Visual Studio
     开始菜单>程序>Microsoft Windows SDK>Visual Studio注册>合并Windows SDK和Visual Studio 2005

   4.获取Chromium depot_tools:
      a.下载depot_tools.zip
      b.解压缩文件(unzip)
        提示：如果你安装了Cygwin,请不要使用unzip解压，它会弄乱许可
      c.添加depot_tools路径到你的PATH中，如：c:bindepot_tools
        提示:默认的，运行gclient同步工具,depot_tools将会自动的将代码更新到最新版本(随时)，
        如果你想关掉此行为请查阅depot_tools文档页内容.

Chromium代码
Chromium代码库中有成千上百个文件，这意味着直接从库中用Subversion验出代码(SVN)将花费很长的时间，为了加快进程处理，我们还提供了一个tarball格式的压缩包文件提供引导下载，二选一，你就可以跳过下载tarball包直接从SVN中获取代码（不推荐此种方法）

提示：目前还没有更好的方法可以直接从SVN得到代码，tarball包中已经包含了SVN中的目录和文件，所以解压缩tarball包后，你可使用glient sync同步工具得到最新的代码。

如果你只是想看源代码，你需要至少1.6G的可用硬盘空间，如果你想编译它，你需要10GB左右的硬盘空间，其中包括所有的中间代码和可执行文件。

引导使用tarball包
   1.确定你有可以解压缩.tar.gz压缩的程序，比如可用的有开源的7-zip压缩
   包管理器，免费的BsdTar工具(libArchive的一部分),和WinZip。

   2.下载源代码的tarball压缩包

   3.选择你要放置源代码的目录，如：c:chromiumtrunk
     重要提示：确信你的目录名中不含空格

   4.解压缩源码包到你选择的目录，如：假如你使用的是libArchive,发出下面的命令：
     "C:Program FilesGnuWin32binbsdtar.exe" -xzf chromium.tgz

   5.可选的操作，同步代码到最新版本
      a.访问Chromium Buildbot watefall页面查看代码树的状态，如果watefall的顶部说：
        OPEN    - 此代码树的状态可行，你可以编译代码，跳转到下一步
        CLOSED - 可能编译或测试特性，你可以下载代码，但你想得到那些特性并试着编译它或测试新的特性，

                     最好重新更新你的代码

      b.在命令行窗口中，执行下面的命令：
        cd c:chromiumtrunk
        gclient sync
        
        在上面的depot工具中已经包含了gclient工具，当第一次运行gclient时，

       它会有一些延迟(一分钟左右),因为它要先更新depot工具。

从SVN检出代码
你将要使用gclient包管理工具从SVN代码库下载chromium的代码    
   1.创建一个目录来放置你的代码，如：c:chromiumtrunk
     重要提示：确信你的目录名称中没有空格

   2.访问Chromium Buildbot watefall页面查看代码树的状态，如果
      watefall的顶部说：
        OPEN    - 此代码树的状态可行，你可以编译代码，跳转到下一步
        CLOSED - 可能编译或测试特性，你可以下载代码，但你想得到那些特性并试着编译它或测试新的特性，

                      最好重新更新你的代码

   3.在命令行窗口中，执行下面的命令：
     cd c:chromiumtrunk
     gclient config http://src.chromium.org/svn/trunk/src
     gclient sync
     
     当第一次运行gclient时，它会有一些延迟(一分钟左右),因为它要先更新depot工具。

     下载Chromium的代码将要花费一个小时左右的时间。

构建并启动Chromium
一旦你有了所有的软件和代码，你就可以构建Chromium并以调试模式启动运行它了。

   1.启动Visual Studio

   2.选择文件>打开项目/解决方案...,到srcchrome目录(c:chromiumrunk或你下载压缩文件后的
   目录),然后打开chrome.sln工程文件。

   3.在解决方案窗口中，在App目录下，右键点击chrome_exe,选择"设置为启动项目"

   4.设置chromium构建所需的用户信息
     
      a.右键点击chrome_exe,选择"属性"
     
      b.在左边栏中，选择"配置属性>调试
  
      c.在右边栏中，改变命令选项成类似下面的:
         --user-data-dir=c:tmpDebugProfile
        
        点确定，chromium将会创建一个指定的信息目录
        (上边例子中的c:tmpDebugProfile),如果此目录不存在的话

        提示：假如你没有设置信息页，当Google Chrome或Chromium已经运行
        时你运行Chromium，将会在已经存在的正运行的浏览器中打开新的窗口，
        这种行为是为了保证浏览器独占一个用户信息，但它意味着你不调试你
        的构建的新版本chromium.
  
        警告：假如最后构建的chromium有一个新的信息格式，Google Chrome
        和旧版本的Chromium可能不能正常读取那个信息格式，除非你设置了信
        息，你可能丢失掉你的Google Chrome信息数据。

   5. 按F5,构建的chrome_exe解决方案并将Chromium运行在调试模式，当你回
   答是否构建过期的项目，请选择是。

   6.构建过程将花费15到40分钟，当构建完毕后，一个浏览器窗口将出现在你
   的窗口中。如果构建出错或没有一个新浏览器窗口出在，请查阅chrome构建
   手册windows版寻求帮助。