Google is committed to advancing racial equity for Black communities. See how.
Ta strona została przetłumaczona przez Cloud Translation API.
Switch to English

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.