Chromium项目环境构建与编译(windows)

一、chromium官方文档http://www.chromium.org/

 

二、下载chromium代码管理工具depot_tools，depot_tools是一个zip压缩包，其中包括了 git, python 等工具，主要用于代码的 拉取、编译、运行、上传。

 

1、下载地址https://commondatastorage.googleapis.com/chrome-infra-docs/flat/depot_tools/docs/html/depot_tools_tutorial.html。

2、将 depot_tools解压到磁盘根目录下，最好与后面存放代码的目录在同一盘符，假设放在E盘， E:\depot_tools。

3、把 E:\depot_tools设置到环境变量的 Path 里，在添加Path环境变量的时候要放在最前面，不要放在后面。

4、打开 cmd导航到 E:\depot_tools, 执行 gclient指令,它将帮你下载安装 python,msysgit, svn 等工具，一定需要通过此方式安装python（通过其他方式安装的或者之前已经安装过python此工具均不能识别，如果实在没办法通过此方式安装的话，需要修改很多地方才能通过）。这一过程需要从 src.chromium.org 下载，所以需要vpn或者代理才能完成这一步！！！如果没有vpn或者代理，基本是完成不了的。下载完成后， python, msysgit 等工具会被释放到 E:\depot_tools 文件夹里（python276_bin文件夹、git-2.10.0-64_bin文件夹、cipd文件等）。

这一过程需要十几分钟，执行结果如下：

三、设置 git. 包括用户名、邮箱等配置文件。

1、打开 cmd 导航到E:\depot_tools, 执行 git bash打开 bash窗口，输入下述指令, user.name 和 user.email 填写你的 git 帐号(名字和邮箱随便填，填写不存在的名字和邮箱也没关系，只是作为一个用户标识，无实际用途)。

内容如下:

$ git config --global user.name "JohnDoe"

$ git config --global user.email"jdoe@email.com"

$ git config --global core.autocrlf false

$ git config --global core.filemode false

$ # and for fun!

$ git config --global color.ui true

2、最后,还可以用 git config --list检查一下自己设置的值是否正确.

四、拉取源代码

1、创建一个文件夹用于存放chromium代码(最好跟depot_tools再同一盘符下)，如 E:\chromium。

2、打开 CMDàE:àcd chromiumàgit bash 打开bash窗口。

3、执行下述指令，拉取chromium代码。

$fetch --nohooks --no-history chromium

--nohooks 表示 check out完成后不要执行 runhooks 指令，也就是不要执行脚本；
--no-history 表示不需要 git history;
不设置 --no-history的话，拉取的代码大概 15G, 设置的话大概 7.2G;
这一过程耗时很长，界面会一直停留在 Running: xxx 的状态持续几个小时， 不要关闭窗口。

代码下载完成后显示如下界面：

五、安装VS2015以及win10SDK

1、 Windows平台下系统必须是Window7 x64 及以后的版本，其它版本、x86 系统不支持。

2、 确保depot_tools已经正确安装。

3、设置系统区域,必须选择英语(美国)

4、 安装VS2015

Windows 平台下必须安装 Visual Studio 2015 Update 2或者更高的版本，

请选择自定义安装，需要选以下几项：

Ÿ  Visual C++, which will select three sub-categoriesincluding MFC

Ÿ  Universal Windows Apps Development Tools > Tools

Ÿ  Universal Windows Apps Development Tools > Windows 10SDK (10.0.10586)

 

5、 必须安装Windows 10 SDK(10.0.10586)或者更高的版本。

6、 最新要求请参考官方文档。

六、runhooks(执行DEPS文件描述的hooks任务)

1、 打开 cmd, 导航到 E:\chromium\src 目录 ，执行下述指令：

SetDEPOT_TOOLS_WIN_TOOLCHAIN=0

setGYP_GENERATORS=ninja,msvs-ninja

setGYP_DEFINES=component=shared_library

setGYP_MSVS_VERSION=2015

gitbash

2、在打开的 bash 窗口，执行下述指令，运行 runhooks

$gclient runhooks

七、编译(GN，GN 是新的编译方式，它的配置文件存储在 BUILD.gn 文件中)

1、 指定GN输出目录，执行下述指令，将在你指定的输出目录里生成一个文件 args.gn文件(GN编译参数配置文件)。

$ gn args out/mybuild

这个文件将会生成在src/out/mybuild目录下,并且会自动打开这个文件。

2、可以编辑刚才自动打开的 args.gn 文本文件或者直接关闭都可以,根据需要看需不需要编辑增加选项以及功能. 关闭后,开始生成gn编译文件

3、 如果希望在生成编译文件的时候同时生成 Visual Studio解决方案和工程,可以使用以下指令:

$ gn gen out\mybuild --ide=vs

编译完成后会在out\mybuild下面生成一个all.sln文件.

4、 最后编译 chrome

使用以下指令:

$ ninja -C out/mybuild chrome。

大概需要6、7个小时可以完成编译，编译后整个chromium

5、具体变化与规则请参考官方最新文档为准