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

Google Chromium开发文档-初级入门指南
2010年07月24日
　　Google Chromium开发文档-初级入门指南Google Chromium开发文档-初级入门指南　　如果你是很认真的想学习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:\bin\depot_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 Files\GnuWin32\bin\bsdtar.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.选择文件>打开项目/解决方案...,到src\chrome目录(c:\chromiumrunk或你下载压缩文件后的
　　　　目录),然后打开chrome.sln工程文件。
　　　　3.在解决方案窗口中，在App目录下，右键点击chrome_exe,选择"设置为启动项目"
　　　　4.设置chromium构建所需的用户信息
　　　　 a.右键点击chrome_exe,选择"属性"
　　　　 b.在左边栏中，选择"配置属性>调试
　　　　 c.在右边栏中，改变命令选项成类似下面的:
　　　　--user-data-dir=c:\tmp\DebugProfile
　　　　 点确定，chromium将会创建一个指定的信息目录
　　　　 (上边例子中的c:\tmp\DebugProfile),如果此目录不存在的话
　　　　 提示：假如你没有设置信息页，当Google Chrome或Chromium已经运行
　　　　 时你运行Chromium，将会在已经存在的正运行的浏览器中打开新的窗口，
　　　　 这种行为是为了保证浏览器独占一个用户信息，但它意味着你不调试你
　　　　 的构建的新版本chromium.
　　　　 警告：假如最后构建的chromium有一个新的信息格式，Google Chrome
　　　　 和旧版本的Chromium可能不能正常读取那个信息格式，除非你设置了信
　　　　 息，你可能丢失掉你的Google Chrome信息数据。
　　　　5. 按F5,构建的chrome_exe解决方案并将Chromium运行在调试模式，当你回
　　　　答是否构建过期的项目，请选择是。
　　　　6.构建过程将花费15到40分钟，当构建完毕后，一个浏览器窗口将出现在你
　　　　的窗口中。如果构建出错或没有一个新浏览器窗口出在，请查阅chrome构建
　　　　手册windows版寻求帮助。