Udział w projekcie WebRTC

Umowa licencyjna

WebRTC obsługuje poprawki i pobierania funkcji oraz poprawek błędów.

W przypadku współtwórców spoza Google wykonaj czynności opisane w Umowie licencyjnej dla współtwórców Google. We wszystkich przypadkach współtwórcy muszą podpisać umowę licencyjną na współtwórcę, zanim przyjmiemy darowiznę. Uzupełnij umowę dla osoby fizycznej lub korporacji.

Przesłane próbki

Jeśli chcesz dodać nową próbkę lub wprowadzić istotne zmiany w dotychczasowej próbce, zalecamy zacząć od utworzenia nowego problemu, w którym omówimy szczegóły.

Tworząc nową próbkę lub aktualizując obecną, pamiętaj, aby utworzyć lub zaktualizować istniejące testy. Wszystkie testy w tym repozytorium są zaimplementowane jako testy interfejsu Nightwatch.JS, więc stosuj się do nich we własnym zakresie.

Instrukcje

Przesłanie pierwszej poprawki

Aby przygotować pierwszą listę zmian, musisz przygotować się na te zmiany:

  • Sprawdź i skompiluj kod
  • Wypełnij umowę programu Contributor (zobacz powyżej)
  • Jeśli kod nie został jeszcze przesłany przez Ciebie, musisz dodać swoje imię i nazwisko oraz dane kontaktowe do pliku AUTHORS
  • Wejdź na 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 polecenie git cl creds-check. Jeśli wystąpią błędy, poproś o pomoc na forum-webrtc.

Nie musisz powtarzać powyższego kroku. Gdy wszystko będzie gotowe, możesz przesłać:

Przesyłanie pierwszej poprawki

Po skonfigurowaniu konta możesz przeprowadzić przesyłanie:

  • Wykonaj te czynności:

    • Załóżmy, że jesteś w głównym oddziale:
      • git checkout -b my-work-branch

    • Wprowadzanie zmian, kompilowanie lokalne, uruchamianie testów lokalnie

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

      Otworzy się edytor tekstu ze wszystkimi lokalnymi komunikatami zatwierdzenia. Możesz go zmodyfikować, zanim stanie się opisem CL.

      Wypełnij poprawnie wpis o błędzie. Podaj prefiks modułu do śledzenia problemów i numer problemu, oddzielając je dwukropkiem, np. webrtc:123 lub chromium:12345. Jeśli nie masz prefiksu numeru i sprawdź numer problemu, dodaj None.

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

      Polecenie wyświetli link jak na przykład https://webrtc-review.googlesource.com/c/src/+/53121. Jeśli wszystko pójdzie poprawnie,

  • Kliknij ten link zmian

  • Jeśli nie jesteś zalogowany, kliknij przycisk Zaloguj się w prawym górnym rogu i zaloguj się,

  • Kliknij Rozpocznij sprawdzanie i dodaj rolę recenzenta. We repozytoriach możesz znaleźć recenzje w plikach OWNERS (wybierz ten, który znajduje się najbliżej Twoich zmian)

  • Odpowiedz na opinię recenzenta:

    • Wprowadzanie zmian, tworzenie lokalnie, uruchamianie testów lokalnie
      • git commit -am "Fixed X and Y"
      • git cl upload

  • Po zobaczeniu poprawki (zatwierdzenia) weryfikatora przez Menedżera tagów Google poproś go, aby umieścił go w kolejce zatwierdzenia.

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

Boty

Jeśli często pracujesz w WebRTC, możesz poprosić o wykorzystanie praw. Oznacza to, że możesz uruchamiać testboty, które przeprowadzają wszystkie testy na wszystkich platformach. Aby to zrobić, zgłoś błąd na bugs.webrtc.org i poproś zespół EngProd o wypróbowanie Twoich praw.

Aby uruchomić proces próbny, prześlij listę zmian zgodnie z powyższym opisem i kliknij CQ (uruchomienie próbne) lub wybierz Try Trybots (Wybierz próby) w interfejsie Gerrit. Aby to zrobić, musisz mieć odpowiednie prawa. W przeciwnym razie poproś recenzenta o uruchomienie botów.