ライセンス契約
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。課題追跡のプレフィックスと課題番号がない場合は、None追加するだけです。ファイルを保存して閉じ、WebRTC コードレビューサーバーへのアップロードを続行します 。
コマンドは、 https://webrtc-review.googlesource.com/c/src/+/53121のようなリンクを出力します 。すべてがうまくいけば。
-
- あなたがマスターブランチにいると仮定します：
このCLリンクをクリック
サインインしていない場合は、右上の[サインイン]ボタンをクリックし、メールでサインインします
[レビューの開始]をクリックして、レビュー担当者を追加します。リポジトリのOWNERSファイルでレビュー担当者を見つけることができます（変更に最も近いレビュー担当者を選択してください）。
レビューアのフィードバックに対処する：
- 変更を加え、ローカルでビルドし、テストをローカルで実行する
-
git commit -am "Fixed X and Y" -
git cl upload
-
- 変更を加え、ローカルでビルドし、テストをローカルで実行する
レビューアLGTMがパッチを承認（承認）したら、コミットキューに入れるよう依頼します。
注意：Windowsでは、 .gitcookiesファイルを見つけるために、Git bashシェルで上記を実行する必要があります。
トライボット
WebRTCで多くの作業をしている場合は、 試用権を申請できます。 つまり 、すべてのプラットフォームですべてのテストを実行するtrybotsを実行できます。これを行うには、bugs.webrtc.orgにバグを提出し、EngProdチームに試用権限を付与するよう依頼してください。
tryjobを実行するには、上記のようにCLをアップロードし、Gerrit UIでCQドライランまたはChoose Trybotsをクリックします。これを試す権利が必要です。それ以外の場合は、レビュー担当者にボットを開始するよう依頼してください。