協助改善 WebRTC 專案

授權合約

WebRTC 歡迎對修補程式/提取功能執行新功能和錯誤修正！

對於 Google 以外的貢獻者，請遵循 Google Individual 著作人授權協議中的指示操作。在所有情況下，協作者必須簽署協作者授權協議，才能接受捐款。請視情況填妥個人或企業協議。

如果您計劃新增樣本，或對現有範例進行重大變更，建議您先建立新問題，方便我們針對詳情進行討論。

建立新樣本或更新現有範例時，請務必一併建立或更新任何現有的測試。該存放區中的所有測試都已實作為 Nightwatch.JS UI 的實作，因此請採用您自己的設計。

您必須先完成一些準備工作，才能上傳第一個 CL：

查看並建構程式碼
填寫捐助計畫協議 (請見上方說明)
如果您從未提交過程式碼，則必須在 AUTHORS 檔案中新增 (或貴機構組織的簽署者協議，如果貴機構簽署了協作者協議) 的名稱和聯絡資訊
前往 https://webrtc.googlesource.com/new-password 並使用您的電子郵件帳戶登入。這應該是 git config user.email 傳回的帳戶
然後執行：git cl creds-check。如果您收到錯誤訊息，請詢問 discuss-webrtc

您就不需要重複上述步驟。完成上述步驟後，您就可以開始上傳：

帳戶設定完畢後，您就可以進行實際上傳：

執行這個動作：
- 假設您已進入主要分支版本：
  - git checkout -b my-work-branch
- 進行變更、在本機上建構、在本機執行測試
  - git commit -am "Changed x, and it is working"
  - git cl upload
  這會開啟文字編輯器，顯示所有本機修訂版本訊息，使其在 CL 說明之前進行修改。
  
  正確填寫錯誤項目。請指定問題追蹤工具前置字串和問題編號，並以半形冒號分隔，例如 webrtc:123 或 chromium:12345。如果您沒有 Issue Tracker 的識別碼和問題編號，只要加上 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 殼層中執行上述操作，才能讓 gclient 找到 .gitcookies 檔案。

如果您在 WebRTC 中處理了許多工作，可以申請嘗試權限。也就是說，您可以執行 trybots，這樣就能在所有平台上執行所有測試。因此，請前往 bugs.webrtc.org 回報錯誤，並請 EngProd 小組授予您相關權限。

如要執行試用工作，請按照上述說明上傳 CL，然後按一下 GQ 模擬測試，或是在 Gerrit UI 中選擇「Trybots」。您必須擁有此權限。否則，請要求審查人員為您啟動機器人。