如果你是很认真的想学习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版寻求帮助。
提示:此文档是提供给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版寻求帮助。