Google 致力于为黑人社区推动种族平等。查看具体行动
此页面由 Cloud Translation API 翻译。
Switch to English

为WebRTC项目做贡献

许可协议

WebRTC欢迎功能/错误修复的补丁/拉动!

对于Google外部的贡献者,请遵循Google个人贡献者许可协议中给出的说明。在任何情况下,贡献者都必须签署贡献者许可协议,然后才能接受贡献。请为个人公司填写适当的协议。

如果您打算添加一个新样本或对现有样本进行重大更改,建议您从创建一个新的问题开始,在此我们可以讨论详细信息。

创建新样品或更新现有样品时,请确保您还创建或更新任何现有测试。该存储库中的所有测试均作为Nightwatch.JS UI测试实现,因此请自行遵循相同的设计。

使用说明

贡献您的第一个补丁

您必须做一些准备才能上传您的第一个CL:

  • 签出并构建代码
  • 填写贡献者协议(请参见上文)
  • 如果您以前从未提交过代码,则必须在AUTHORS文件中添加您的(或在您的组织签署了贡献者协议的情况下,您所在组织的)名称和联系信息。
  • 转到https://webrtc.googlesource.com/new-password并使用您的电子邮件帐户登录。此帐户应与git config user.email返回的帐户相同
  • 然后,运行: git cl creds-check 。如果遇到任何错误,请寻求有关ask -webrtc的帮助

您不必重复上述步骤。毕竟,您可以上传了:

上传您的第一个补丁

现在,您已经设置了帐户,可以进行实际的上传了:

  • 做这个:

    • 假设您在master分支上:
      • git checkout -b my-work-branch
    • 进行更改,本地构建,本地运行测试

      • git commit -am "Changed x, and it is working"
      • git cl upload

      这将打开一个显示所有本地提交消息的文本编辑器,使您可以在它成为CL描述之前对其进行修改。

      正确填写错误条目。请指定问题跟踪器前缀和问题编号,以冒号分隔,例如webrtc:123chromium:12345 。如果您没有问题跟踪器前缀和问题编号,只需添加None

      保存并关闭文件,以继续上载到WebRTC 代码检查服务器

      该命令将显示https://webrtc-review.googlesource.com/c/src/+/53121之类的链接。如果一切顺利。

  • 点击此CL链接

  • 如果您尚未登录,请单击右上角的“登录”按钮,然后使用电子邮件登录

  • 单击开始审阅并添加审阅者。您可以在存储库附近的OWNERS文件中找到审阅者(请选择与您的更改最接近的审阅者)

  • 解决任何审阅者的反馈意见:

    • 进行更改,本地构建,本地运行测试
      • git commit -am "Fixed X and Y"
      • git cl upload
  • 一旦审阅者LGTM(批准)补丁,要求他们将其放入提交队列中

注意:在Windows上,您需要在Git bash shell中运行以上命令,以便gclient找到.gitcookies文件。

尝试机器人

如果您在WebRTC中工作很多,则可以申请试用权 。这意味着您可以运行trybots ,它们可以在所有平台上运行所有测试。为此,请在bugs.webrtc.org上提交一个错误,并要求EngProd团队授予您尝试权限。

要运行tryjob,请按照上述说明上载CL,然后在Gerrit UI中单击CQ空运行或选择Trybots。您需要具有尝试权限。否则,请您的审稿人为您启动机器人。