编译webKit
Webkit已然成为当前最炙手可热的开源浏览器内核,从手机到电脑很常见的浏览器都是基于webkit内核的,研究webkeit对于一个程序员来说是件很让人振奋的事儿,然后要研究这个开源的瑰宝,首先就需要编译它,经过将近一个星期的研究,历经我也不知道有多少次的失败终于终于我还是编译成功了。下面我将我这次的编译的详细过程记录下来,在我看来是对网上的早期编译文档的一次版本更新吧
编译环境的搭建
建议搭建基本环境到webkit官网浏览英文介绍http://www.webkit.org/building/tools.html以及下载编译所需要的所有文件,我在我机器上的测试环境为:
Window7 32位旗舰版操作系统,4G内存(编译最大达到内存占用2.5G),处理器Inter(R)Core(TM) i3 CPU M370 @2.4GHz,编译版本为:WebKit-r132317,下面是环境搭建详细,建议安装全部选中默认路径以免编译错误。
1. 安装VS 2005 team suite 英文试用版下载地址如下:
2. 安装Microsoft Visual Studio 2005 Team SuiteService Pack 1,下载地址如下:
3. 如果是win7的系统需要安装VisualStudio 2005 Service Pack 1 ATL Security Update
4. 安装一下的四个补丁:
a) KB918559
b) KB935225
c) KB943969
d) KB947315
5. 安装cygwin 利用官网专门提供的一个下载工具cygwin-downloader.zip.运行cygwin-downloader.exe会自动下载并在压缩包中生成一个release文件夹,下载完成后会自动启动安装程序setup.exe执行安装,然后选择本地文件也就是release文件夹,建议安装到C:\cygwin避免编译产生无可预知错误,选择文件夹的时候默认为全部default我建议更改为install。
6. 去http://developer.apple.com/quicktime/download/下载一个quicktime sdk,需要注册才能下载,必须安装。
7. 安装DirectX SDK下载February 2010DirectX SDK(新版本不支持vs2005)
8. (可选安装,为了避免错误我安装了)安装windows调试工具,有些测试工程和脚本需要这些工具根据这个介绍安装instructions for installing the 32-bit version ofDebugging Tools for Windows.
获取源码
1. 对于源码的获取可以直接下载在http://nightly.webkit.org/ 第三个下载项“Source”。20M左右。
2. 下载一个补丁包,WebKitSupport Libraries这个压缩包包含了Apple的几个非开源库的Windows port。下完后放在Webkit源码解压后的根目录:~/WebKit-r132317/(注意这个补丁包不要解压)
设置环境变量
1. 设置cygwin的环境变量,在path中添加C:\cygwin\bin;
2. 新建环境变量WEBKITLIBRARIESDIR其值为WebKit 源代码目录\WebKitLibraries\win
3. 新建环境变量WEBKITOUTPUTDIR其值设为你打算要存放obj和dll 的输出文件夹,当然这个文件夹所在的分区至少要有4G的剩余空间。
4. 说明:WEBKITOUTPUTDIR可以随便设,如果要保持和其他Build方式的一致性,那么就设置成为%WEBKIT_DIR%\output,这里%WEBKIT_DIR%是Webkit文件夹的绝对路径。WEBKITLIBRARIESDIR必须设置为%WEBKIT_DIR%\Web`KitLibraries\win文件夹。
比如将WEBKIT_DIR设置为E:\project\WebKi t-r132317
WEBKITOUTPUTDIR则可以设置为%WEBKIT_DIR%\output
WEBKITLIBRARIESDIR则可以设置为%WEBKIT_DIR%\WebKitLibraries\win
运行cygwin(我源码在D盘,WEBKITOUTPUTDIR为源码内新建的ouput文件夹)
1. 执行以下命令
export WEBKITLIBRARIESDIR=D:\\WebKit-r131283\\WebKitLibraries\\win
export WEBKITOUTPUTDIR=D:\\WebKit-r131283\\output
2. 转到webkit源码的\Tools\Scripts目录(例如我的:cd D:/WebKit-r132317/Tools/Scripts)
执行./update-webkit 此命令会下载WebKitAuxiliaryLibrary.zip,并安装,执行成功
失败则表示cygwin安装有问题!
3. 然后在执行./update-webkit-support-libs命令安装一个文件包也会提示成功。(此步比较重要,不执行会出现很多错误,网上很多文档都没有写)
开始编译
1. 启动vs2005 打开
D:\WebKit-r132317\Source\WebKit\win\WebKit.vcproj\WebKit.sln工程
2. 选择编译模式单纯的Debug和Release,这里我选择Debug
3. 选择DumpRenderTree,QTMovieWin, WebCore, WebKit, WinLauncher等所有项目(把c++项目的属性都设置一遍)的项目属性,左侧选择“C/C++”,将右侧的“Treat Warnings As Errors”(“将警告视为错误”)设置为“No”。这个必须设置。否则编译时会报错
4. WebKit-r132317默认的项目启动项为JavaScriptCore文件夹下的jsc工程,这回导致每次编译到此停止不前,所以又右键单击Tools文件夹下的MiniBrowserLauncher工程,选择Set as StartUp Project设为项目启动项
5. 好了,如果按照以上配置到这步就可以编译,按下F7或者点击编译图标开始编译。
6. 我的机器上经过大约一个小时的编译,出现一个错误:fatal error C1057: unexpected end of file in macro expansion原因是编码的问题,修改错误代码如下:
#if USE(CF)
RetainPtr<CFStringRef>selectedCFString(AdoptCF,truncatedStringForLookupMenuItem(selectedString).createCFString());
returnformatLocalizedString(WEB_UI_STRING("Look Up Dictionary", "LookUp context menu item with selected word"), selectedCFString.get());
#else
returnWEB_UI_STRING("Look Up “<selection>”", "Look Up contextmenu item with selected word").replace("<selection>",truncatedStringForLookupMenuItem(selectedString));
#endif
#endif
7. 修改后再次编译,如果一切顺利的话最终会打开一个程序MiniBrowser.exe 但是无法正常运行,因为还缺少很多的dll文件,这时候需要下载Safari浏览器并安装了,然后复制其安装目录C:/Program Files/CommonFiles/Apple/Apple Application Support下的所有dll文件到编译目录D:\WebKit-r132317\output\Debug\bin下,注意:最好不要覆盖掉QTMovieWin.dll,WebKit.dll和JavaScriptCore.dll 这三个dll文件,然后再次编译,如果一切配置正确则编译成功运行MiniBrowser.exe 默认打开网页为webkit官网页面,输入www.baidu.com可以执行
至于调试,我也不会后续会了再发文章了。
可能会出现的问题
错误:fatalerror C1083: Cannot open include file: 'stdint.h': No such file or directory
解决:执行./update-webkit-support-libs命令
错误:NMAKE :fatal error U1077: 'touch' : return code '0x1'
解决:cygwin安装目录没有配置环境变量
错误:..\wtf\dtoa.cpp(1100): error C2220: warning treated as error - no 'object' file generated
解决:修改对应的dtoa.cpp文件属性->配置属性->c/c++->常规,将“警告视为错误”的选项改为“否”
错误:errorPRJ0002 : Error result 1 returned from 'C:\Windows\system32\cmd.exe'.
解决:此错误是由于依赖模块间错误造成,个模块没有错误了,此错误便消失
错误:在cygwin中执行build-webkit报错:-bash:webkit/Tools/Scripts/build-webkit: /usr/bin/perl: bad interpreter: Permissiondenied
解决:安装cygwin问题,没有安装perl包,建议使用cygwin提供的下载器下载安装时选择perl为install
总结:下载的源码是肯定没有代码本身上的错误,唯一的也是编码造成的一个很明显的error C2220: warning treated as error - no 'object' file generated错误,相信其他的错误都是由于配置不当造成的,所以搭建编译环境时最好全部选择默认路径安装不要更改,虽然我也不喜欢把软件安装在C盘,但是没有办法,所以C盘空间要足够,今天才编译成功,接下来就是调试学习了,往此文档能早日助你完成编译!
时间2012年10月30日