為 WebRTC 專案提供貢獻

授權協議

WebRTC 歡迎功能和錯誤修正的修補程式/拉取要求!

如果是 Google 以外的貢獻者,請按照 Google 個人貢獻者授權協議中的指示操作。無論如何,提案者都必須先簽署提案者授權協議,才能接受提案。請視情況填寫個人公司的協議。

提供樣本

如果您打算新增新樣本,或對現有樣本進行重大變更,建議您先建立新問題,以便我們討論相關細節。

建立新樣本或更新現有樣本時,請務必一併建立或更新任何現有測試。該存放區中的所有測試都會以 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:123chromium:12345。如果沒有 Issue Tracker 前置字串和問題編號,請直接新增 None

      儲存並關閉檔案,即可繼續將檔案上傳至 WebRTC Code Review Server

      如果一切順利,指令會列印類似 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 檔案。

Trybots

如果您經常使用 WebRTC,可以申請試用權。這表示您可以執行 trybots,在所有平台上執行所有測試。如要這樣做,請在 bugs.webrtc.org 上提交錯誤,並要求 EngProd 團隊授予您試用權。

如要執行試驗工作,請按照上述方式上傳 CL,然後在 Gerrit UI 中點選「CQ 模擬執行」或「選擇 Trybots」。您必須具備試用權限,才能執行這項操作。否則,請要求審查員為您啟動機器人。