GYP使用技巧

轉載自: 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的同學還是很多的,改變生成工程很簡單。

  1. 使用環境變量,GYP_MSVS_VERSION=2008

  2. 使用命令行參數, -G msvs_version=2008

相關的版本可以填2005, 2008, 2010, 2005e, 2008e等,(支持的版本還是很多的,連express版本都有!)

定製相關參數

構建系統的一大任務就是根據不同需要確定編譯參數,需要編譯的子工程,設置相關的宏參數使得C或者C++代碼正確編譯。GYP在選項相關的管理是自己做的,也就是說如果要改變相關的選項,就要更新生成的工程。不過看源代碼可以知道,GYP選項這部分相當的弱,使用相當古怪的語法。這個之後慢慢說明,同樣的,定製參數也有兩種方法

  1. 環境變量法, 如GYP_DEFINES=windows_sdk_path="path to sdk",不過在cmd下環境變量的方法只能定義一個,而且不能包含空格,不推薦使用這個方法

  2. 命令行參數,-D XXX -D YYY=ZZZ

GYP代碼分析

博主尚未研究透,後續再說

發佈了6 篇原創文章 · 獲贊 9 · 訪問量 5萬+
發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章