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: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 (승인)하면 커밋 대기열에 추가해 달라고 요청합니다.

참고: Windows에서는 gclient가 .gitcookies 파일을 찾을 수 있도록 Git bash 셸에서 위의 명령어를 실행해야 합니다.

Trybots

WebRTC에서 많은 작업을 하는 경우 무료 체험 권한을 신청할 수 있습니다. 즉, 모든 플랫폼에서 모든 테스트를 실행하는 trybots를 실행할 수 있습니다. 이렇게 하려면 bugs.webrtc.org에서 버그를 신고하고 EngProd팀에 사용 권한을 부여해 달라고 요청하세요.

tryjob을 실행하려면 위에서 설명한 대로 CL을 업로드하고 Gerrit UI에서 CQ 예비 실행 또는 Trybots 선택을 클릭합니다. 이 기능을 사용하려면 체험판 권한이 있어야 합니다. 그렇지 않으면 검토자에게 봇을 시작해 달라고 요청하세요.