Współtworzenie projektu WebRTC

Umowa licencyjna

WebRTC chętnie przyjmuje poprawki i pull requesty dotyczące funkcji i poprawek błędów.

W przypadku współpracowników spoza Google postępuj zgodnie z instrukcjami podanymi w Umowie licencyjnej Google dla indywidualnych autorów. W każdym przypadku, zanim wkład zostanie zaakceptowany, jego autor musi podpisać umowę licencyjną. W odpowiednich przypadkach wypełnij umowę dotyczącą osoby fizycznej lub korporacji.

Przesyłanie próbek

Jeśli planujesz dodać nowy przykład lub wprowadzić istotne zmiany w dotychczasowym, zacznij od utworzenia nowego problemu, abyśmy mogli omówić szczegóły.

Podczas tworzenia nowej próbki lub aktualizowania istniejącej pamiętaj, aby utworzyć lub zaktualizować testy. Wszystkie testy w tym repozytorium są implementowane jako testy interfejsu Nightwatch.JS, więc w swoich testach stosuj ten sam układ.

Instrukcje

Przesyłanie pierwszego poprawki

Aby przesłać pierwszy plik CL, musisz się do tego odpowiednio przygotować:

  • Sprawdzanie i kompilowanie kodu
  • Wypełnij umowę Contributor (patrz wyżej).
  • Jeśli nigdy wcześniej nie przesłałeś kodu, musisz dodać swoje imię i nazwisko (lub nazwę organizacji, jeśli umowa dla współtwórców została podpisana przez Twoją organizację) oraz informacje kontaktowe do pliku AUTHORS.
  • Otwórz stronę https://webrtc.googlesource.com/new-password i zaloguj się na swoje konto e-mail. Powinno to być to samo konto, które zwróciła funkcja git config user.email
  • Następnie uruchom: git cl creds-check. Jeśli pojawią się błędy, poproś o pomoc na stronie discuss-webrtc.

Nie musisz powtarzać tych czynności. Po wykonaniu tych czynności możesz przesłać:

Przesyłanie pierwszej poprawki

Gdy już skonfigurujesz konto, możesz rozpocząć przesyłanie:

  • Wykonaj te czynności:

    • Zakładając, że jesteś na głównej gałęzi:
      • git checkout -b my-work-branch

    • Wprowadzanie zmian, kompilowanie lokalnie, przeprowadzanie testów lokalnie

      • git commit -am "Changed x, and it is working"
      • git cl upload

      Spowoduje to otwarcie edytora tekstu ze wszystkimi lokalnymi wiadomościami zatwierdzenia, co pozwoli Ci je zmodyfikować, zanim staną się opisem CL.

      Właściwie wypełnij formularz błędu. Podaj prefiks śledzenia problemów i numer problemu rozdzielone dwukropkiem, np. webrtc:123 lub chromium:12345. Jeśli nie masz prefiksu śledzenia problemu ani numeru problemu, dodaj None.

      Zapisz i zamknij plik, aby kontynuować przesyłanie na serwer sprawdzania kodu WebRTC.

      Jeśli wszystko pójdzie dobrze, polecenie wypisze link podobny do https://webrtc-review.googlesource.com/c/src/+/53121.

  • Kliknij ten link do listy zmian

  • Jeśli nie jesteś zalogowany(-a), w prawym górnym rogu kliknij przycisk Zaloguj się i użyj adresu e-mail.

  • Kliknij Rozpocznij sprawdzanie i dodaj weryfikatora. Odbiorców możesz znaleźć w plikach OWNERS w repozytorium (wybierz ten, który jest najbliżej Twoich zmian).

  • Odpowiedz na opinie recenzenta:

    • Wprowadzaj zmiany, kompiluj lokalnie i przeprowadzaj testy lokalnie.
      • git commit -am "Fixed X and Y"
      • git cl upload

  • Gdy sprawdzający zatwierdzi poprawkę, poproś o dodanie jej do kolejki commit

UWAGA: w Windows musisz uruchomić powyższe polecenie w powłoce Git Bash, aby gclient znalazł plik .gitcookies.

Trybots

Jeśli często korzystasz z WebRTC, możesz ubiegać się o prawa do testowania. Oznacza to, że możesz uruchomić trybots, które przeprowadzają wszystkie testy na wszystkich platformach. Aby to zrobić, prześlij zgłoszenie błędu na stronie bugs.webrtc.org i poproś zespół EngProd o przyznanie Ci uprawnień do testowania.

Aby przetestować kod, prześlij go w sposób opisany powyżej i kliknij opcję Testowanie CQ lub Wybierz testy w interfejsie Gerrit. Musisz mieć uprawnienia do testowania. W przeciwnym razie poproś sprawdzającego o wyłączenie botów.