如果您有興趣了解谷歌測試,從來源,或派遣的想法或修改項目、 建筑內(nèi)部本文檔將是你。
簡介
首先,讓我們給您項目的一些背景。
發(fā)牌
根據(jù)新的 BSD 許可證提供所有谷歌測試源和預(yù)編譯的程序包.
谷歌測試社區(qū)
谷歌測試社區(qū)已經(jīng)存在,主要是透過討論組,問題跟蹤器和幅度較小,源代碼管理儲存庫。你肯定鼓勵參與討論,您還可以幫助我們保持高集團的效果后,促進在此處列出的準(zhǔn)則。
請將友好
顯示的禮貌和尊重他人是在谷歌文化的重要組成部分和我們強烈鼓勵大家參與谷歌測試開發(fā)加盟不接受。當(dāng)然,禮貌并不相同,未有建設(shè)性地不同意對方,但它意味著枚舉 42 技術(shù)原因某項建議可能不是最佳選擇時我們應(yīng)該互相尊重。沒有理由拮抗或輕視向任何人真誠地試圖進行的討論作出貢獻。
肯定的是,c + + 測試是嚴(yán)肅的商業(yè)和其它的東西,但它也有很多樂趣。讓我們保持這種方式。讓我們努力成為所有開放源碼中最友好的社區(qū)之一。
討論谷歌測試的位置
一如既往,討論谷歌測試的官方谷歌 c + + 測試框架的討論組。你不必實際提交代碼,以便簽約。您的參與本身是寶貴的貢獻。
使用代碼
如果你想把你的手弄臟與內(nèi)谷歌測試的代碼,這是你的部分。
簽出顛覆的來源
簽出谷歌測試源是最有用的如果您計劃調(diào)整自己。谷歌測試使用顛覆客戶端,但 Google Code 上承載的任何其他項目簽出源。請如何做這件事的源代碼訪問頁,參閱該指令。
從源代碼編譯
一旦您簽出該代碼,您可以找到有關(guān)如何編譯它的自述文件中的說明。
測試
一個測試框架是不好,如果本身不徹底的測試。測試應(yīng)編寫的任何新的代碼,并應(yīng)在提交審查不打破現(xiàn)有的測試驗證更改。要執(zhí)行測試,按照自述文件中的說明,并驗證不存在任何故障。
貢獻代碼
我們很激動谷歌測試現(xiàn)在是開源的和希望從社會得到很大的修補程序。在您最喜愛的 IDE 點燃并開始地敲擊著這項新功能之前,不過,請花時間閱讀本節(jié)和理解這一進程。盡管它看起來嚴(yán)格,我們要保持高標(biāo)準(zhǔn)的質(zhì)量基本代碼。
參與者的許可協(xié)議
我們可以接受任何代碼之前,您必須注冊參與者許可協(xié)議 (CLA)。共軛亞油酸保護您和我們。
- 如果您是個人寫作原始源代碼,你知道你自己的知識產(chǎn)權(quán),那么你需要簽署個別共軛亞油酸.
- 如果你工作的公司想要允許您將您的工作有助于谷歌測試,然后將需要簽署公司共軛亞油酸.
按照上面的兩個鏈接訪問相應(yīng)的共軛亞油酸和簽署并返回它的說明。
編碼風(fēng)格
若要保持源一致的、 可讀的 diffable 和易于合并,我們使用相當(dāng)死板的編碼風(fēng)格,如由google styleguide項目定義。預(yù)計所有修補程序?qū)⒎纤龅娘L(fēng)格在這里.
更新生成的代碼
谷歌測試的源代碼文件的一些由泵工具 (Python 腳本) 生成。如果您需要更新這些文件,請修改源 (foo.h.pump),并重新生成的 c + + 文件使用泵。您可以閱讀PumpManual的詳細信息。
提交的修補程序
請不要提交代碼。下面是您需要做什么:
- 通常您應(yīng)進行更改 SVN 樹干的分支或標(biāo)記,而不是針對后面的兩個版本控制,應(yīng)被視為主要為只讀。
- 決定您想提交哪些的代碼。提交應(yīng)解決一個問題中的Google 測試問題跟蹤器的一組更改。請不要混合多個邏輯更改每提交,因為它使歷史難追。如果你想有所改變,在問題跟蹤器沒有一個相應(yīng)的問題,請創(chuàng)建一個。
- 此外,協(xié)調(diào)與團隊成員的問題上列出。這可以確保工作不正在復(fù)制和溝通你的計劃早一般也會導(dǎo)致更好的修補程序。
- 確保您的代碼堅守谷歌測試源代碼樣式.
- 確保您的代碼的單元測試。
- 簽名參與者的許可協(xié)議。
- 創(chuàng)建使用svn diff修補程序文件.
- 我們使用里特韋爾進行基于 web 的代碼審查。您可以閱讀有關(guān)該工具在這里。當(dāng)您準(zhǔn)備就緒時上, 傳您的修補程序通過冶金并通知googletestframework@googlegroups.com作出檢討。有幾種方法可以上載該修補程序。我們建議使用upload_gtest.py腳本中,您可以查找腳本 / SVN 樹干中的文件夾。
谷歌測試獨立自主
谷歌測試工程團隊的當(dāng)前成員目前是唯一的獨立自主。在吃自己的試用的偉大傳統(tǒng),我們亦會規(guī)定每個新來賺取權(quán)成為委員會按照下面的過程在此文檔中,谷歌測試工程團隊成員編寫代碼始終很大,并演示重復(fù)他或她真正獲取谷歌測試的禪宗。
發(fā)布過程
我們遵循顛覆基于項目的典型釋放過程:
- 創(chuàng)建名為釋放 X.Y釋放分支。
- Bug 固定的樹干 ; 添加的功能這些個別的修補程序合并到釋放科才穩(wěn)定。
- 個人單點發(fā)行版 ( Z在X.Y.Z) 提出從分支創(chuàng)建標(biāo)簽。
- 重復(fù)步驟 2 和 3,整個一個發(fā)布周期 (如由功能或時間)。
- 返回到步驟 1,創(chuàng)建另一個版本分支,等等。
此頁基于從谷歌 Web 工具包項目指南使 GWT 更好。除了作為則指出,該網(wǎng)頁的內(nèi)容被許可創(chuàng)新知識共享署名 2.5 許可證.