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ółautorzy muszą podpisać umowę licencyjną współautora, 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 UI 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 przesłałeś kodu, musisz dodać swoje (lub organizację w przypadku, gdy umowa współautora jest podpisywana przez 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 jakieś 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
Po skonfigurowaniu konta 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
lubchromium:12345
. Jeśli nie masz prefiksu śledzenia problemów i numeru problemu, po prostu dodajNone
.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.
-
- Zakładając, że jesteś w głównej gałęzi:
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
-
- Wprowadzaj zmiany, buduj lokalnie, uruchamiaj testy lokalnie
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 uprawnienia 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ć próbę, załaduj CL, jak opisano powyżej, i kliknij opcję CQ próbnego uruchomienia lub Wybierz trybots w interfejsie użytkownika Gerrit. Musisz mieć prawo do prób. W przeciwnym razie poproś recenzenta, aby wyrzucił boty za Ciebie.