Wkład w projekt WebRTC

Umowa licencyjna

WebRTC z zadowoleniem przyjmuje łatki / ściągnięcia funkcji i poprawek błędów!

W przypadku współautorów spoza Google postępuj zgodnie z instrukcjami podanymi w Umowie licencyjnej na indywidualnego współtwórcę Google . We wszystkich przypadkach współpracownicy muszą podpisać umowę licencyjną, zanim wkład będzie mógł zostać zaakceptowany. Wypełnij umowę odpowiednio dla osoby fizycznej lub korporacji .

Jeśli planujesz dodać nową próbkę lub wprowadzić istotne zmiany w istniejącej próbce, zalecamy rozpoczęcie od utworzenia nowego wydania, w którym będziemy mogli omówić szczegóły.

Tworząc nową próbkę lub aktualizując istniejącą, upewnij się, że utworzyłeś również lub zaktualizowałeś wszystkie istniejące testy. Wszystkie testy w tym repozytorium są zaimplementowane jako testy interfejsu użytkownika Nightwatch.JS, więc prosimy o wykonanie tego samego projektu we własnym.

Instrukcje

Przekazywanie Twojej pierwszej poprawki

Aby załadować swój pierwszy plik CL, musisz trochę się przygotować:

Sprawdź i skompiluj kod
Wypełnij umowę współtwórcy (patrz wyżej)
Jeśli nigdy wcześniej nie przesyłałeś kodu, musisz dodać swoje (lub organizację w przypadku, gdy umowa o współautorstwie jest podpisywana przez Twoją organizację) imię i nazwisko oraz dane kontaktowe do pliku AUTHORS
Przejdź do https://webrtc.googlesource.com/new-password i zaloguj się na swoje konto e-mail. Powinno to być to samo konto, które zostało zwrócone przez git config user.email
Następnie uruchom: git cl creds-check . Jeśli napotkasz jakiekolwiek błędy, poproś o pomoc na stronie discuss-webrtc

Nie będziesz musiał powtarzać powyższego. Po tym wszystkim możesz przesłać:

Przesyłanie pierwszej poprawki

Teraz, gdy masz już skonfigurowane konto, możesz wykonać faktyczne przesyłanie:

Zrób to:
- Zakładając, że jesteś w głównej gałęzi:
  - git checkout -b my-work-branch
- Wprowadzaj zmiany, buduj lokalnie, uruchamiaj testy lokalnie
  - git commit -am "Changed x, and it is working"
  - git cl upload
  Spowoduje to otwarcie edytora tekstu pokazującego wszystkie lokalne komunikaty o zatwierdzeniach, umożliwiając modyfikację go, zanim stanie się opisem CL.
  Wypełnij poprawnie wpis błędu. Podaj prefiks modułu do śledzenia problemów i numer problemu oddzielone dwukropkiem, np. webrtc:123 lub chromium:12345 . Jeśli nie masz prefiksu śledzenia problemów i numeru problemu, po prostu dodaj None .
  Zapisz i zamknij plik, aby kontynuować przesyłanie na serwer przeglądu kodu WebRTC.
  Polecenie wydrukuje link, taki jak https://webrtc-review.googlesource.com/c/src/+/53121 . Jeśli wszystko pójdzie dobrze.
Kliknij łącze CL
Jeśli nie jesteś zalogowany, kliknij przycisk Zaloguj się w prawym górnym rogu i zaloguj się za pomocą swojego adresu e-mail
Kliknij Rozpocznij recenzję i dodaj recenzenta. Możesz znaleźć recenzentów w plikach OWNERS w całym repozytorium (wybierz to, które jest najbliżej twoich zmian)
Zwróć się do opinii recenzentów:
- Wprowadzaj zmiany, buduj lokalnie, uruchamiaj testy lokalnie
  - git commit -am "Fixed X and Y"
  - git cl upload
Gdy recenzent LGTM zatwierdzi (zatwierdzi) poprawkę, poproś o umieszczenie jej w kolejce zatwierdzania

UWAGA: W systemie Windows musisz uruchomić powyższe w powłoce Git bash, aby program gclient mógł znaleźć plik .gitcookies .

Trybots

Jeśli dużo pracujesz w WebRTC, możesz ubiegać się o prawa do prób . Oznacza to, że możesz uruchomić tryboty , które przeprowadzają wszystkie testy na wszystkich platformach. Aby to zrobić, zgłoś błąd na bugs.webrtc.org i poproś zespół EngProd o przyznanie Ci uprawnień do prób.

Aby uruchomić tryjob, załaduj CL jak opisano powyżej i kliknij albo CQ dry run, albo Choose Trybots w interfejsie użytkownika Gerrit. Musisz mieć prawo do prób. W przeciwnym razie poproś recenzenta, aby wyrzucił boty za Ciebie.