Google is committed to advancing racial equity for Black communities. See how.
本頁面由 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。您需要具有嘗試權限。否則,請您的審稿人為您啟動機器人。