Contribuire al progetto WebRTC

Contratto di licenza

WebRTC accoglie con favore patch/pull per funzionalità e correzioni di bug.

I collaboratori esterni a Google devono seguire le istruzioni riportate nel Contratto di licenza per i collaboratori individuali di Google. In tutti i casi, i collaboratori devono firmare un contratto di licenza per i collaboratori prima che un contributo possa essere accettato. Compila il contratto per un privato o una società, come appropriato.

Contribuire con Samples

Se prevedi di aggiungere un nuovo sample o di apportare modifiche significative a uno esistente, ti consigliamo di iniziare creando un nuovo problema in cui possiamo discutere dei dettagli.

Quando crei un nuovo Sample o ne aggiorni uno esistente, assicurati di creare o aggiornare anche i test esistenti. Tutti i test in questo repository sono implementati come test UI di Nightwatch.JS, quindi segui lo stesso design nel tuo.

Istruzioni

Inviare la prima patch

Per caricare il tuo primo CL, devi svolgere alcuni passaggi preliminari:

  • Esegui il checkout e compila il codice
  • Compila il contratto di collaboratore (vedi sopra)
  • Se non hai mai inviato codice, devi aggiungere il tuo nome (o quello della tua organizzazione, se il contratto di collaboratore è firmato dalla tua organizzazione) e i tuoi dati di contatto al file AUTHORS.
  • Vai alla pagina https://webrtc.googlesource.com/new-password e accedi con il tuo account email. Deve essere lo stesso account fornito da git config user.email
  • Dopodiché, esegui: git cl creds-check. Se ricevi errori, chiedi aiuto su discuss-webrtc

Non dovrai ripetere quanto sopra. Dopodiché, potrai caricare:

Caricamento del primo patch

Ora che hai configurato il tuo account, puoi procedere con il caricamento effettivo:

  • Azione da eseguire:

    • Supponendo che tu stia utilizzando il ramo principale:
      • git checkout -b my-work-branch

    • Apporta modifiche, esegui il build localmente ed esegui test localmente

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

      Si aprirà un editor di testo che mostra tutti i messaggi di commit locali, consentendoti di modificarli prima che diventino la descrizione del CL.

      Compila correttamente la voce del bug. Specifica il prefisso del tracker dei problemi e il numero del problema, separati da due punti, ad esempio webrtc:123 o chromium:12345. Se non hai un prefisso del tracker dei problemi e un numero di problema, aggiungi None.

      Salva e chiudi il file per procedere con il caricamento sul server di revisione del codice WebRTC.

      Se tutto va bene, il comando stamperà un link come https://webrtc-review.googlesource.com/c/src/+/53121.

  • Fai clic su questo link a CL

  • Se non hai eseguito l'accesso, fai clic sul pulsante Accedi in alto a destra e accedi con il tuo indirizzo email.

  • Fai clic su Inizia revisione e aggiungi un revisore. Puoi trovare i revisori nei file OWNERS nel repository (scegli quello più vicino alle modifiche)

  • Rispondere a eventuali feedback del team di revisione:

    • Apporta modifiche, esegui il build localmente ed esegui test localmente
      • git commit -am "Fixed X and Y"
      • git cl upload

  • Una volta che l'esaminatore ha approvato la patch, chiedigli di inserirla nella fila di commit

AVVISO: su Windows, devi eseguire quanto sopra in una shell Git Bash affinché gclient trovi il file .gitcookies.

Trybots

Se utilizzi molto WebRTC, puoi richiedere i diritti di prova. Ciò significa che puoi eseguire i trybots, che eseguono tutti i test su tutte le piattaforme. Per farlo, invia un bug su bugs.webrtc.org e chiedi al team EngProd di concederti i diritti di prova.

Per eseguire un tryjob, carica un CL come descritto sopra e fai clic su Prova secca CQ o Scegli Trybot nell'interfaccia utente di Gerrit. Per farlo, devi disporre dei diritti di prova. In caso contrario, invita il revisore a avviare i bot per te.