Chrome Visual Studio 2005下的编译过程
编译篇
研究Chrome ,首先得把它编译出来,这对于后续的代码分析和阅读有很大的帮助,想想自己编译出一个 Chrome 浏览器来使用,那是一件很炫的事情。
编译环境准备
Chrome的编译和 WebKit 相比起来,难度上来说,简直是一元二次方程求解和偏微分方程求解的对比(我到现在还没有完整的把 WebKit 编译出来,鄙视一下自己)。虽然 Chrome 也是从 WebKit 演进过来,差不多也就是把 WebKit 的 JS 引擎替换成了 V8 。但是不得不承认 Google 把 WebKit 的编译难度降低了几个数量级。
言归正传,Chrome 官方网站上公布的是基于 Visual Studio 2005 进行编译,网上也有兄弟基于 Visual Studio 2008 编译成功过,但我手头上没有 Visual Stdio 2008 ,所以无从得知。本文也是以 Visual Studio2005 环境为例。我曾经在自己家里的电脑上用 Visual C++ 2005 Express 版本编译过,没有成功。在 XP Professional 和 Vista Home 两个操作系统上均编译成功。
在下载Chrome 代码前,需要安装下面几个软件:
1. 安装Visual Studio 2005.
2. 安装 Visual Studio 2005 Service Pack 1 .
3. 安装热补丁 Hotfix 947315 .
4. 如果操作系统是Vista ,还需要安装 Visual Studio 2005 Service Pack 1 Update for Windows Vista 。
5. 安装 Windows 2008 SDK 。按照网上说法,如果是Visual Studio 2008 ,就不需要安装这个了。
6. 配置Windows 2008 SDK 。在开始 -> 程序 -> Microsoft Windows SDK v6.1 > Visual Studio Registration > Windows SDK Configuration Tool .。选择 make current 按钮,幸运的话,应该能一次成功。如果不能成功, Chrome 官方网站上有一个 手动配置 的帮助,大家可以参考。
下载 代码
Google为 Chrome 提供了一个一个部署工具 depot_tools ,包括下载代码、同步代码、上传代码等功能。这个工具采用Python 编写的,其中还包含了一些 Javascript 脚本。 Depot_tools 中包含了一个 gclient 工具,是我们需要关注的重点。
下载代码有几 种 方式:
1. Chrome官网上提供了一个 源代码包 ,可以直接下载下来。不过这个包并不是最新的包。我采用的是这种方法进行下载的,相对来说比较快。
2. 采用SVN 客户端工具进行下载,比如 TortoiseSVN 客户端工具, SVN 服务器地址是 http://src.chromium.org/svn/trunk/src 。
3. 采用google 提供的 depot_tools 工具。
l 下载和安装 depot_tools 。
l 把depot_tools 的安装目录设置到系统目录(系统 Path 环境变量 ) 中。
l 创建一个存放Chrome 代码的目录,比如 d:\chrome 。目录不要包含空格。
l 在命令行下,先将当前目录切换到chrome 代码的目录,例如上面的 (d:\chrome) 。
l 运行 gclient config http://src.chromium.org/svn/trunk/src 命令。Gclient 将会先下载 svn 工具和 python 工具,然后调用 svn 进行代码同步。
注意: gclient 中下载svn 和 python 采用的是 javascript 实现。如果在需要设置 proxy 的环境中,则需要需要修改一下脚本。
1. 打开X:\ depot _tools\bootstrap\win\get_file.js文件。其中 X 是你的安装盘符。
2. 将Line9-Line22 行之间的代码
try {
xml_http = new ActiveXObject("MSXML2.ServerXMLHTTP");
} catch (e) {
WScript.StdOut.WriteLine("[-] XMLHTTP " + new Number(e.number).toHex() +
": Cannot create Active-X object (" + e.description) + ").";
WScript.Quit(1);
}
try {
xml_http.open("GET", url, false);
} catch (e) {
WScript.StdOut.WriteLine("[-] XMLHTTP " + new Number(e.number).toHex() +
": invalid URL.");
WScript.Quit(1);
}
修改成
try {
xml_http = new ActiveXObject("MSXML2. ServerXMLHTTP.5.0 ");
} catch (e) {
WScript.StdOut.WriteLine("[-] XMLHTTP " + new Number(e.number).toHex() +
": Cannot create Active-X object (" + e.description) + ").";
WScript.Quit(1);
}
try {
xml_http.setProxy(2, proxyIP:Port);
xml_http.open("GET", url, false);
xml_http. setProxyCredentials(username,pwd);
} catch (e) {
WScript.StdOut.WriteLine("[-] XMLHTTP " + new Number(e.number).toHex() +
": invalid URL.");
WScript.Quit(1);
}
编译 代码
如果你是下载的源代码包,则需要先解压,这个代码包是双重压缩。估计要把所有代码解压下来,半个小时左右,我在我的本本上是花了将近半个小时时间才解压出来,解压下来所有代码的大小是3 个多 G 。
从网上搜索了很久相关Chrome 编译相关的材料,大家都反馈在 src\chrome 目录下有 chrome.sln 文件,直接打开这个 sln 就可以利用 Visual Studio 2005 进行编译了。但是我翻遍所有代码却找不到这个文件,让我郁闷了很久,开始怀疑是我下的代码版本问题,在线查看了 Chrome 的 SVN 目录,发现最新版本也没有这个文件了。检查一下网上的那些文章基本上都是 2008 年的文章,开始怀疑是否是 chrome 做了改变,但是从 chrome 的官网上:
Building Chromium
1 Open the chrome/chrome.sln solution file in Visual Studio and build the solution. This can take from 25 minutes to 1 hour.
2 If you just want the Chromium browser, and none of the tests, you can speed up your build by right-clicking the chrome project in the solution explorer and selecting Build . You may want to make sure this project is the Startup project (which will display as bold) by right-clicking it and selecting Set as Startup Project . This will make Chromium (as opposed to some random test) build and run when you press F5 .
来看,似乎没有更新。最后在线翻阅了chrome 的开发 group 论坛,才知道 Chrome 确实作了修改,原来代码中的那些 .sln 、 .vcproj 文件全部抛弃了, google 自己开发了一个脚本工具 GYP 工具,这个工具也是采用python 编写的。 GYP 采用了自定义的一套规则,用于生成各种工程文件。我们可以看一下下面这个gyp 文件。
{
'includes': [
'../../build/common.gypi',
],
'targets': [
{
'target_name': 'memory_watcher',
'type': 'shared_library',
'msvs_guid': '3BD81303-4E14-4559-AA69-B30C3BAB08DD',
'dependencies': [
'../../base/base.gyp:base',
],
'defines': [
'BUILD_MEMORY_WATCHER',
],
'include_dirs': [
'../..',
],
'sources': [
'call_stack.cc',
'call_stack.h',
'dllmain.cc',
'hotkey.h',
'ia32_modrm_map.cc',
'ia32_opcode_map.cc',
'memory_hook.cc',
'memory_hook.h',
'memory_watcher.cc',
'memory_watcher.h',
'mini_disassembler.cc',
'preamble_patcher.cc',
'preamble_patcher.h',
'preamble_patcher_with_stub.cc',
],
},
],
}
其实这个文件的内容和visual studio 2005 中的 .vcproj 文件虽然有比较大的差别,但是描述的东西没有太大变化,更简单更简洁一些而已。无非描述了工程的文件,编译设置等内容。
下面描述一下编译步骤:
1. 运行命令行工具。
2. 切换到Chrome 主目录下(我的电脑是 d:\chrome 目录)。
3. 执行gclient runhooks --force 。这个命令将会调用 GYP 工具,对 Chrome.gyp 进行解析,生成各个 Visual Studio2005 工程文件。
4. 双击chrome/chrome.sln 文件,即可打开 Visual Studio 2005 ,一共有 215 个工程,非常庞大。
右键选择解决方案,选择生成解决方案,编译开始了。这个过程在我的本本里是持续了2 个小时左右, CPU 前一个多小时都是持续 100% ,害得我连看电影都卡的不行了。编译后的文件放置在 chrome\debug 目录下(我编译的是 debug 版本)。整个编译下来, Debug 目录增加了将近 7 个 G 的东东,实在是恐怖!要编译 Chrome ,至少要保留 10 个 G 的空间。
总结
整个编译Chrome 的过程说实话还是花了我不少的力气,不过看着编译出来的 chrome, 心里还是很 happy 的。
在我编译的过程中主要遇到的几个问题:
1. 公司有Visual Studio2005 ,可是因为 Proxy 的原因, depot_tools 工具无法进行,为了突破 proxy 的限制,花了不少力气。
2. Chrome工程组织方式发生了变化,但在官网上没有更新,网上其他的资料都是基于旧的版本介绍,所以在适应新的 gyp 方式方面花了不少力气。