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"[email protected]"

$ 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、具體變化與規則請參考官方最新文檔爲準