授權協議
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:123
或chromium: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」。您必須具備試用權限,才能執行這項操作。否則,請要求審查員為您啟動機器人。