为 WebRTC 项目做出贡献

许可协议

WebRTC 为新功能和问题修复提供了补丁程序/提取功能！

对于 Google 之外的贡献者，请按照 Google 个人贡献者许可协议中的说明操作。在任何情况下，贡献者都必须接受贡献者许可协议，才能接受贡献内容。请视情况为个人或企业签署协议。

如果您计划添加新示例或对现有示例进行重大更改，我们建议您首先创建新问题，以便我们讨论详细信息。

创建新示例或更新现有示例时，请确保同时创建或更新现有的任何测试。该代码库中的所有测试均以 Nightwatch.JS 界面测试的形式实现，因此请遵循您自己的设计。

要上传第一个 CL，您必须做一些准备：

签出并构建代码
填写贡献者协议（参见上文）
如果您以前从未提交过代码，则您必须将自己的姓名（如果是贵组织签署的贡献者协议，则注明贵组织）和联系信息添加到 AUTHORS 文件
转到 https://webrtc.googlesource.com/new-password 并使用您的电子邮件帐号登录。该帐号应与 git config user.email 返回的帐号相同
然后，运行 git cl creds-check。如果遇到任何错误，请在 forum-webrtc 上寻求帮助

您无需重复执行上述操作。完成上述操作后，您就可以上传图片了：

现在您的帐号已设置完毕，您可以进行实际上传了：

执行此操作：
- 假设您位于 main 分支上：
  - git checkout -b my-work-branch
- 进行更改、在本地构建、在本地运行测试
  - git commit -am "Changed x, and it is working"
  - git cl upload
  这将打开一个文本编辑器，显示所有本地提交消息，让您可以在它成为 CL 说明之前对其进行修改。
  
  正确填写错误条目。请指定问题跟踪器前缀和问题编号，并用英文冒号分隔，例如 webrtc:123 或 chromium: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，在所有平台上运行所有测试。为此，请在 bug.webrtc.org 上提交错误，并请求 EngProd 团队授予您试用权限。

要运行 tryjob，请按如上所述上传 CL，然后点击 CQ 试运行或者在 Gerrit 界面中选择 Trybots。您需要有相关权限，才能执行此操作。否则，请让审核者为您启动聊天机器人。