Google Chromium開發文檔-初級入門指南
如果你是很認真的想學習Chromium是如何工作的,那麼此文檔就是專為你準備的。你将得到Chromium的代碼然後編譯它。然後你将使用Visual Studio 2005debugger調試它,看它是怎樣運作的,更深入點,你會知道它是如何處理來自使用者的操作的。
提示:此文檔是提供給Windows系統開發員和測試員的,并告訴他們它是如何運作代碼的,如果你還沒有設定好編譯環境,你可以查閱"文檔"頁,如果你用的系統不是Windows,請查閱為Mac和Linux(我翻譯的另一篇文章,建構linux版本的chrome)使用者準備的編譯指南.
擷取你需要的軟體
這節将告訴你如何設定你的Windows系統的編譯環境,如果你遇到了問題或想了解更多資訊,請查閱"編譯指南(Windows版)"
滿足前提條件的軟體
首先,你的計算機必需安裝了以下軟體:
*Windows XP(SP2或更高版本) 或 Windows Vista
*Microsoft Visual Studio 2005(8.0)
附加軟體(免費)下載下傳
Visual Studio安裝後,你需要下載下傳并安裝許多的相關軟體
1.下載下傳并安裝Microsoft Visual Studio 2005 Service Pack 1.
視你的計算機具體情況,安裝可能要花費一個小時的時間,并且安裝後需要重新啟動計算機。
2.下載下傳并安裝Microsoft Windows SDK。
安裝完畢後需要重新啟動計算機,可以不安裝文檔和代碼示例,這樣可以減少硬碟空間。
提示:雖然SDK說自己隻能用在Vista上,其實XP和Vista兩個系統平台都可以使用,
如果你已經有Microsoft 2008 SDk了,那麼你就不需要下載下傳一個新的了。
3.整合SDK和Visual Studio
開始菜單>程式>Microsoft Windows SDK>Visual Studio注冊>合并Windows SDK和Visual Studio 2005
4.擷取Chromium depot_tools:
a.下載下傳depot_tools.zip
b.解壓縮檔案(unzip)
提示:如果你安裝了Cygwin,請不要使用unzip解壓,它會弄亂許可
c.添加depot_tools路徑到你的PATH中,如:c:\bin\depot_tools
提示:預設的,運作gclient同步工具,depot_tools将會自動的将代碼更新到最新版本(随時),
如果你想關掉此行為請查閱depot_tools文檔頁内容.
Chromium代碼
Chromium代碼庫中有成千上百個檔案,這意味着直接從庫中用Subversion驗出代碼(SVN)将花費很長的時間,為了加快程序處理,我們還提供了一個tarball格式的壓縮封包件提供引導下載下傳,二選一,你就可以跳過下載下傳tarball包直接從SVN中擷取代碼(不推薦此種方法)
提示:目前還沒有更好的方法可以直接從SVN得到代碼,tarball包中已經包含了SVN中的目錄和檔案,是以解壓縮tarball包後,你可使用glient sync同步工具得到最新的代碼。
如果你隻是想看源代碼,你需要至少1.6G的可用硬碟空間,如果你想編譯它,你需要10GB左右的硬碟空間,其中包括所有的中間代碼和可執行檔案。
引導使用tarball包
1.确定你有可以解壓縮.tar.gz壓縮的程式,比如可用的有開源的7-zip壓縮
包管理器,免費的BsdTar工具(libArchive的一部分),和WinZip。
2.下載下傳源代碼的tarball壓縮包
3.選擇你要放置源代碼的目錄,如:c:\chromiumtrunk
重要提示:确信你的目錄名中不含空格
4.解壓縮源碼包到你選擇的目錄,如:假如你使用的是libArchive,發出下面的指令:
"C:\Program Files\GnuWin32\bin\bsdtar.exe" -xzf chromium.tgz
5.可選的操作,同步代碼到最新版本
a.通路Chromium Buildbot watefall頁面檢視代碼樹的狀态,如果watefall的頂部說:
OPEN??? - 此代碼樹的狀态可行,你可以編譯代碼,跳轉到下一步
CLOSED - 可能編譯或測試特性,你可以下載下傳代碼,但你想得到那些特性并試着編譯它或測試新的特性,
最好重新更新你的代碼
b.在指令行視窗中,執行下面的指令:
cd c:\chromiumtrunk
gclient sync
在上面的depot工具中已經包含了gclient工具,當第一次運作gclient時,
它會有一些延遲(一分鐘左右),因為它要先更新depot工具。
從SVN檢出代碼
你将要使用gclient包管理工具從SVN代碼庫下載下傳chromium的代碼???
1.建立一個目錄來放置你的代碼,如:c:\chromiumtrunk
重要提示:确信你的目錄名稱中沒有空格
2.通路Chromium Buildbot watefall頁面檢視代碼樹的狀态,如果
watefall的頂部說:
OPEN??? - 此代碼樹的狀态可行,你可以編譯代碼,跳轉到下一步
CLOSED - 可能編譯或測試特性,你可以下載下傳代碼,但你想得到那些特性并試着編譯它或測試新的特性,
最好重新更新你的代碼
3.在指令行視窗中,執行下面的指令:
cd c:\chromiumtrunk
gclient config http://src.chromium.org/svn/trunk/src
gclient sync
當第一次運作gclient時,它會有一些延遲(一分鐘左右),因為它要先更新depot工具。
下載下傳Chromium的代碼将要花費一個小時左右的時間。
建構并啟動Chromium
一旦你有了所有的軟體和代碼,你就可以建構Chromium并以調試模式啟動運作它了。
1.啟動Visual Studio
2.選擇檔案>打開項目/解決方案...,到src\chrome目錄(c:\chromiumrunk或你下載下傳壓縮檔案後的
目錄),然後打開chrome.sln工程檔案。
3.在解決方案視窗中,在App目錄下,右鍵點選chrome_exe,選擇"設定為啟動項目"
4.設定chromium建構所需的使用者資訊
a.右鍵點選chrome_exe,選擇"屬性"
b.在左邊欄中,選擇"配置屬性>調試
c.在右邊欄中,改變指令選項成類似下面的:
--user-data-dir=c:\tmp\DebugProfile
點确定,chromium将會建立一個指定的資訊目錄
(上邊例子中的c:\tmp\DebugProfile),如果此目錄不存在的話
提示:假如你沒有設定資訊頁,當Google Chrome或Chromium已經運作
時你運作Chromium,将會在已經存在的正運作的浏覽器中打開新的視窗,
這種行為是為了保證浏覽器獨占一個使用者資訊,但它意味着你不調試你
的建構的新版本chromium.
警告:假如最後建構的chromium有一個新的資訊格式,Google Chrome
和舊版本的Chromium可能不能正常讀取那個資訊格式,除非你設定了信
息,你可能丢失掉你的Google Chrome資訊資料。
5. 按F5,建構的chrome_exe解決方案并将Chromium運作在調試模式,當你回
答是否建構過期的項目,請選擇是。
6.建構過程将花費15到40分鐘,當建構完畢後,一個浏覽器視窗将出現在你
的視窗中。如果建構出錯或沒有一個新浏覽器視窗出在,請查閱chrome建構
手冊windows版尋求幫助。
