如果您有兴趣了解谷歌测试,从来源,或派遣的想法或修改项目、 建筑内部本文档将是你。
简介
首先,让我们给您项目的一些背景。
发牌
根据新的 BSD 许可证提供所有谷歌测试源和预编译的程序包.
谷歌测试社区
谷歌测试社区已经存在,主要是透过讨论组,问题跟踪器和幅度较小,源代码管理储存库。你肯定鼓励参与讨论,您还可以帮助我们保持高集团的效果后,促进在此处列出的准则。
请将友好
显示的礼貌和尊重他人是在谷歌文化的重要组成部分和我们强烈鼓励大家参与谷歌测试开发加盟不接受。当然,礼貌并不相同,未有建设性地不同意对方,但它意味着枚举 42 技术原因某项建议可能不是最佳选择时我们应该互相尊重。没有理由拮抗或轻视向任何人真诚地试图进行的讨论作出贡献。
肯定的是,c + + 测试是严肃的商业和其它的东西,但它也有很多乐趣。让我们保持这种方式。让我们努力成为所有开放源码中最友好的社区之一。
讨论谷歌测试的位置
一如既往,讨论谷歌测试的官方谷歌 c + + 测试框架的讨论组。你不必实际提交代码,以便签约。您的参与本身是宝贵的贡献。
使用代码
如果你想把你的手弄脏与内谷歌测试的代码,这是你的部分。
签出颠覆的来源
签出谷歌测试源是最有用的如果您计划调整自己。谷歌测试使用颠覆客户端,但 Google Code 上承载的任何其他项目签出源。请如何做这件事的源代码访问页,参阅该指令。
从源代码编译
一旦您签出该代码,您可以找到有关如何编译它的自述文件中的说明。
测试
一个测试框架是不好,如果本身不彻底的测试。测试应编写的任何新的代码,并应在提交审查不打破现有的测试验证更改。要执行测试,按照自述文件中的说明,并验证不存在任何故障。
贡献代码
我们很激动谷歌测试现在是开源的和希望从社会得到很大的修补程序。在您最喜爱的 IDE 点燃并开始地敲击着这项新功能之前,不过,请花时间阅读本节和理解这一进程。尽管它看起来严格,我们要保持高标准的质量基本代码。
参与者的许可协议
我们可以接受任何代码之前,您必须注册参与者许可协议 (CLA)。共轭亚油酸保护您和我们。
- 如果您是个人写作原始源代码,你知道你自己的知识产权,那么你需要签署个别共轭亚油酸.
- 如果你工作的公司想要允许您将您的工作有助于谷歌测试,然后将需要签署公司共轭亚油酸.
按照上面的两个链接访问相应的共轭亚油酸和签署并返回它的说明。
编码风格
若要保持源一致的、 可读的 diffable 和易于合并,我们使用相当死板的编码风格,如由google styleguide项目定义。预计所有修补程序将符合所述的风格在这里.
更新生成的代码
谷歌测试的源代码文件的一些由泵工具 (Python 脚本) 生成。如果您需要更新这些文件,请修改源 (foo.h.pump),并重新生成的 c + + 文件使用泵。您可以阅读PumpManual的详细信息。
提交的修补程序
请不要提交代码。下面是您需要做什么:
- 通常您应进行更改 SVN 树干的分支或标记,而不是针对后面的两个版本控制,应被视为主要为只读。
- 决定您想提交哪些的代码。提交应解决一个问题中的Google 测试问题跟踪器的一组更改。请不要混合多个逻辑更改每提交,因为它使历史难追。如果你想有所改变,在问题跟踪器没有一个相应的问题,请创建一个。
- 此外,协调与团队成员的问题上列出。这可以确保工作不正在复制和沟通你的计划早一般也会导致更好的修补程序。
- 确保您的代码坚守谷歌测试源代码样式.
- 确保您的代码的单元测试。
- 签名参与者的许可协议。
- 创建使用svn diff修补程序文件.
- 我们使用里特韦尔进行基于 web 的代码审查。您可以阅读有关该工具在这里。当您准备就绪时上, 传您的修补程序通过冶金并通知googletestframework@googlegroups.com作出检讨。有几种方法可以上载该修补程序。我们建议使用upload_gtest.py脚本中,您可以查找脚本 / SVN 树干中的文件夹。
谷歌测试独立自主
谷歌测试工程团队的当前成员目前是唯一的独立自主。在吃自己的试用的伟大传统,我们亦会规定每个新来赚取权成为委员会按照下面的过程在此文档中,谷歌测试工程团队成员编写代码始终很大,并演示重复他或她真正获取谷歌测试的禅宗。
发布过程
我们遵循颠覆基于项目的典型释放过程:
- 创建名为释放 X.Y释放分支。
- Bug 固定的树干 ; 添加的功能这些个别的修补程序合并到释放科才稳定。
- 个人单点发行版 ( Z在X.Y.Z) 提出从分支创建标签。
- 重复步骤 2 和 3,整个一个发布周期 (如由功能或时间)。
- 返回到步骤 1,创建另一个版本分支,等等。
此页基于从谷歌 Web 工具包项目指南使 GWT 更好。除了作为则指出,该网页的内容被许可创新知识共享署名 2.5 许可证.