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

      テキスト エディタが開き、すべてのローカル commit メッセージが表示されます。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（承認）したら、commit キューに追加するよう依頼します。

注: Windows では、gclient が .gitcookies ファイルを検出できるように、Git bash シェルで上記のコマンドを実行する必要があります。

Trybots

WebRTC を頻繁に使用している場合は、試用権を申請できます。つまり、すべてのプラットフォームですべてのテストを実行する trybots を実行できます。これを行うには、bugs.webrtc.org でバグを報告し、EngProd チームに試用権を付与するよう依頼します。

tryjob を実行するには、上記の手順に沿って CL をアップロードし、Gerrit UI で [CQ dry run] または [Choose Trybots] をクリックします。これを行うには、試用権限が必要です。そうでない場合は、ボットの開始を審査担当者に依頼してください。