使用許諾契約
WebRTC では、機能とバグ修正へのパッチや pull を受け付けています。
Google 外部の協力者の場合は、Google 個人コントリビューター ライセンス契約の手順に従ってください。いずれの場合も、コントリビューションを受け付けるには、コントリビューター ライセンス契約に署名する必要があります。必要に応じて、個人または企業の契約を完了してください。
サンプルの寄与
新しいサンプルを追加する場合や、既存のサンプルに大幅な変更を加える場合は、最初に新しい問題を作成して詳細を確認することをおすすめします。
新しいサンプルを作成する、または既存のサンプルを更新する場合は、必ずテストを作成または更新してください。このリポジトリでのすべてのテストは Nightwatch.JS UI テストとして実装されるため、独自のデザインを採用してください。
手順
最初のパッチを提供する
最初の CL をアップロードするには、以下の準備が必要です。
- コードを確認してビルドする
- コントリビューター契約を締結する（上記を参照）
- まだコードを送信したことがない場合は、投稿者の名前とコントリビューター契約を 作成している場合は、組織の名称を入力します。
- 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
すべてのローカル commit メッセージを表示するテキスト エディタが開き、CL の説明になる前に変更できます。
バグエントリを適切に入力します。公開バグトラッカーの接頭辞と問題番号をコロンで区切って入力してください（例:
webrtc:123、chromium:12345）。Issue Tracker のプレフィックスおよび問題番号がない場合は、Noneを追加してください。ファイルを保存して閉じ、WebRTC コードレビュー サーバーにアップロードします。
このコマンドは、https://webrtc-review.googlesource.com/c/src/+/53121 のようなリンクを出力します。
- メインブランチにいることを前提とします。
この CL リンク
ログインしていない場合は、右上の [Sign in] ボタンをクリックしてメールアドレスでログインします。
[クチコミを開始] をクリックしてクチコミ投稿者を追加します。リポジトリの OWNERS ファイルでレビュー担当者を確認できます（変更に最も近いレビューアを取得します）
審査担当者のフィードバックに対応するには:
- 変更、ローカルでのビルド、ローカルでのテストの実行
git commit -am "Fixed X and Y"git cl upload
- 変更、ローカルでのビルド、ローカルでのテストの実行
レビュー担当者の LGTM がパッチを承認（承認）したら、パッチの commit キューに入れるよう依頼する。
注: Windows では、gclient が .gitcookies ファイルを見つけるために、Git bash シェルで上記のコマンドを実行する必要があります。
Trybot
WebRTC で多くの業務を行っている場合は、トライアルの権利を申請できます。つまり、すべてのプラットフォームですべてのテストを実行する trybot を実行できます。その場合は、bugs.webrtc.org でバグを報告し、EngProd チームに権利の付与をご依頼ください。
tryjob を実行するには、上記のように CL をアップロードし、Gerrit UI で CQ ドライランまたは [Trybots] を選択します。この操作を行うには権限が必要です。それ以外の場合は、bot を開始するようにレビュー担当者に依頼します。