heX 及 HeXium 編譯指南

包括下載，構(gòu)建工程，編譯源代碼

背景知識

heX 依賴 Chromium、CEF 和 Node.js 項目。在下載 heX 源代碼之前，需要先準備好指定版本的 Chromium 源代碼，但不需要下載 CEF 和 Node.js 項目源代碼，因為構(gòu)建工具會自動下載它們。

以上項目的首頁：

• Chromium: http://www.chromium.org
• CEF: https://code.google.com/p/chromiumembedded
• Node.js: https://github.com/joyent/node

下載 Chromium 源代碼

Chromium 的項目 WIKI 中有非常詳細的下載步驟，可通過 svn 或者 git，以及所需要的 depot_tools。參見：http://dev.chromium.org/developers/how-tos/get-the-code。

而 Chromium 是一個巨大的項目，若通過 SVN 獲取其源代碼會耗費大量的時間。為了節(jié)省寶貴的時間可以直接下載源代碼包。下面主要介紹一下快速下載的方法：

1. 在瀏覽器中打開此鏈接：http://chromium-browser-source.commondatastorage.googleapis.com
2. 在 heX 源代碼根目錄的 CHROMIUM_BUILD_COMPATIBILITY 文件中查找指定的 Chromium 版本號
3. 在上面的鏈接所指的 XML 文件中找一個與指定版本號最接近的版本。如，查找 rXXXXXX
4. 下載這個最接近的版本號的源代碼包
5. 解壓并且進入到包中 src 目錄的父目錄
6. 執(zhí)行 gclient sync --revision src@指定的Chromium版本號 --force --jobs 32
7. 一會兒之后，指定版本的 Chromium 源代碼會更新完畢
   注意：似乎在升級到 blink 內(nèi)核之后，步驟 1 的列表已經(jīng)不再更新。

檢出 heX 和 HeXium 源代碼

heX 和 HeXium 共享同一套源代碼，通過不同的構(gòu)建工具來生成對應的工程。heX 的源代碼必須放置在 Chromium 源代碼的 src 目錄下。檢出 URL 是 https://github.com/netease-youdao/hex.git。

代碼檢出后，目錄結(jié)構(gòu)會是：

src - base
      hex
      ...

準備編譯環(huán)境

從源代碼編譯 heX 及 HeXium 目前暫時支持 Windows 和 Mac OS X，其中 Mac OS X 下編譯 heX 還存在一些問題，會在近期修正。至少需要 4GB 系統(tǒng)內(nèi)存，推薦 8GB 甚至 16GB 內(nèi)存。

為了編譯 Chromium、Node.js、CEF 以及 heX 源代碼，你必須從這里開始配置編譯環(huán)境，在系統(tǒng)中安裝編譯前期必要的開發(fā)環(huán)境。請參考：

• CEF
  
  • https://code.google.com/p/chromiumembedded/wiki/BranchesAndBuilding
• Node.js
  
  • https://github.com/joyent/node/wiki/installation
• Chromium：
  
  • http://www.chromium.org/developers/how-tos/build-instructions-windows (Windows)
  • http://code.google.com/p/chromium/wiki/MacBuildInstructions (Mac OS X)

完成上述配置后，你需要下載指定版本的 Node.js 與 CEF，并且通過 GYP 生成工程文件。heX 的構(gòu)建工具會自動將下載 Node.js、CEF 與生成工程文件，只需在 heX 源代碼目錄中執(zhí)行 hex.bat 或 hex_end_user.bat (end user 版本) 即可。

編譯 heX

heX 的自動構(gòu)建工具會根據(jù)當前的平臺生成對應的工程文件：

• Windows：用 Visual Studio 打開剛生成的 hex.sln，將 hexclient 工程設置為啟動工程，編譯！
• Mac OS X：用 Xcode 打開剛生成的 hex.xcodeproj，編譯！

一段時間之后（這取決于你的計算機硬件配置），你會在 src/hex/build 目錄中找到編譯的結(jié)果。

編譯 HeXium

HeXium 本質(zhì)上是一個經(jīng)過修改的加入了 Node.js 的 Chromium 瀏覽器。這個子項目并不需要 CEF 的支持。

在運行了上面提到的 hex.bat 腳本之后，進入 Chromium 源代碼 src 的上層目錄，運行 gclient hooks。這樣做是確保用于編譯 HeXium 的全部工程文件構(gòu)建正確。

工程文件構(gòu)建完畢后進入 src/chrome 目錄中找到

• Windows：chrome.sln
• Mac OS X：chrome.xcodeproj

并使用默認的 IDE 打開，編譯！

比編譯 heX 更久的一段時間之后（這同樣取決于你的計算機硬件配置），你會在

• Windows：src/build/Debug or Release
• Mac OS X：src/xcodebuild/Debug or Release

中找到編譯的結(jié)果。