轉載自:http://lianliuwei.github.io/tools/2012/09/10/gyp-misc/
GYP簡介
Again,這又是一個Google創造的編程工具,現在已經用在了Chomium和其相關的工程中,使用是越來越廣泛。GYP是Generate Your Projects的縮寫,你可能會問,“又一個?,為什么?”,是的,這個世界上已經有很多的工程生成工具,Automake, make, CMake, Visual Studio, Scons。GYP對比這些工具有這些優點:
-
各平臺下使用主流的構建系統
看似沒什么,但這是一個相當重要的特性,程序員都是懶惰的,提供的工具鏈最好是相應平臺主流的開發工具,比如Windows下必然要用Visual Studio,不要搞什么Cgywin,msys之類的編譯鏈,也不要如Scons那樣,編譯還要用命令行,而且這樣有一個好處,就是速度問題不用自己考慮了,由相關的構建系統負責。
-
不用在特定平臺上生成構建系統文件
GYP生成相關的文件是不需要在特定的平臺下,因為它文件格式,版本等信息都自己描述好了,比Automake生成Visual C++工程還要用調用Visual Studio好多了(沒有核實過)
-
生成的文件跟手工創建的文件沒有區別
這意味著你可以用到一半不用GYP了,直接用生成的工程文件繼續項目,或者提交工程文件到版本庫中,項目其他成員就不用學習GYP,Automake生成的工程就屬于機器代碼,各種間接調用,各種神秘的宏。
-
生成工程后就無需GYP
可以看出GYP就是以Automake為競爭對手,解決的也是Automake中設計失誤,使得這個工具專注生成工程。
chromium工程09年以前用的Scons構建工具,后來改成GYP的方法,當初開發者抱怨最多的就是不熟悉構建系統,使用不方便,速度慢,可以看出使用native的工具鏈是多么重要。
git倉庫
官網給出的是SVN倉庫,不過就如同chromium的其他工程,都有一個對應的git工程,git倉庫比SVN倉庫好就不說了,直接上地址http://git.chromium.org/external/gyp.git,博主上傳了一份到github上https://github.com/lianliuwei/gyp (不保證是同步的)
GYP結構
GYP的輸入是.gyp和.gypi文件,.gypi文件是用于.gyp文件include使用的。.gyp文件就是符合特定格式的json文件。
gyp文件中包含target,Visual C++下,gyp生成sln,target生成vcproj或vxcproj。
chromium中GYP結構是,通過命令行統一使用build/common.gypi的公共文件,工程的配置,選項的處理,編譯選項的使用,都是在這個文件中配置,所有造成了這個文件超級大,129KB。生成一個總工程all.gyp
,這個工程依賴于其他所有的工程,這個工程生成,所有工程都生成完成。而且有一個總工程也方便開發。
如果要使用GYP,建議依照chromium的結構,common.gypi也用chromium的進行裁剪,畢竟各種選項的選擇也是需要經驗的。
使用GYP
chromium工程中的方法是使用build/gyp_chromium這個Python腳本來調用,這個腳本實現添加公共配置,偵測附加配置,添加需要的編譯選項。
一般使用沒必要使用這么復雜的腳本,直接使用一個bat文件就都搞定。
chromium_base工程示例
build_proj.bat
call setup_env.bat
tools\gyp\gyp.bat --depth . -D component=shared_library --no-circular-check -G msvs_version=2008 -Ibuild/common.gypi build_add/all.gyp
setup_env.bat
:: This script adds python to the path
@echo OFF
set PATH=C:\Python\Python27;%PATH%
setup_env.bat的作用就是設置Python路徑,單獨分離出來不但是為了更方便的修改,而且是以后工程中VS調用Python命令行用(這個之后再解釋)
關機的是build_proj.bat。使用了GYP調用的總入口,gyp/gyp.bat
。--depth
是為了定義工程的根目錄在哪里,需要給出。-D
設置GYP中的參數, --no-circular-check
是chromium代碼中的問題,一般GYP文件是不允許環形依賴的,但是由于歷史原因chromium中的依賴關系還沒有解決,如果你使用chromium中的GYP,建議加上這個選項,不然就得自己解決環形依賴。-Ibuild/common.gypi
用來加載所有工程的公用文件。build_add/all.gyp
是總的工程文件。
定制生成工程
現在默認GYP在Windows下生成Visual Studio 2010工程,但是使用2008的同學還是很多的,改變生成工程很簡單。
-
使用環境變量,GYP_MSVS_VERSION=2008
-
使用命令行參數, -G msvs_version=2008
相關的版本可以填2005, 2008, 2010, 2005e, 2008e等,(支持的版本還是很多的,連express版本都有!)
定制相關參數
構建系統的一大任務就是根據不同需要確定編譯參數,需要編譯的子工程,設置相關的宏參數使得C或者C++代碼正確編譯。GYP在選項相關的管理是自己做的,也就是說如果要改變相關的選項,就要更新生成的工程。不過看源代碼可以知道,GYP選項這部分相當的弱,使用相當古怪的語法。這個之后慢慢說明,同樣的,定制參數也有兩種方法
-
環境變量法, 如GYP_DEFINES=windows_sdk_path="path to sdk"
,不過在cmd下環境變量的方法只能定義一個,而且不能包含空格,不推薦使用這個方法
-
命令行參數,-D XXX -D YYY=ZZZ
GYP代碼分析
博主尚未研究透,后續再說