Contribuindo para o projeto WebRTC

Acordo de Licença

WebRTC agradece patches / pulls para recursos e correções de bugs!

Para contribuidores externos ao Google, siga as instruções fornecidas no Contrato de licença de contribuidor individual do Google . Em todos os casos, os contribuidores devem assinar um contrato de licença de contribuidor antes que uma contribuição possa ser aceita. Conclua o contrato para um indivíduo ou empresa, conforme apropriado.

Contribuindo com amostras

Se você planeja adicionar uma nova amostra ou fazer alterações significativas em uma amostra existente, recomendamos que comece criando um novo problema onde possamos discutir os detalhes.

Ao criar uma nova amostra ou atualizar uma existente, certifique-se de criar ou atualizar quaisquer testes existentes. Todos os testes nesse repositório são implementados como testes de IU Nightwatch.JS, portanto, siga o mesmo design do seu.

Instruções

Contribuindo com seu primeiro patch

Você deve fazer alguma preparação para fazer o upload do seu primeiro CL:

• Confira e construa o código
• Preencha o contrato de Contribuidor (veja acima)
• Se você nunca enviou o código antes, deve adicionar o seu (ou o da sua organização, no caso de o contrato do contribuidor ser assinado por sua organização) e informações de contato ao arquivo AUTHORS
• Vá para https://webrtc.googlesource.com/new-password e faça login com sua conta de e-mail. Deve ser a mesma conta retornada por git config user.email
• Em seguida, execute: git cl creds-check . Se você receber algum erro, peça ajuda em discuss-webrtc

Você não terá que repetir o acima. Depois de tudo isso, você está pronto para fazer upload:

Enviando seu primeiro patch

Agora que você configurou sua conta, pode fazer o upload real:

• Fazem isto:

  • Supondo que você esteja no branch master:
    • git checkout -b my-work-branch

  • Faça alterações, crie localmente, execute testes localmente

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

    Isso abrirá um editor de texto mostrando todas as mensagens de commit locais, permitindo que você as modifique antes que se torne a descrição do CL.

    Preencha a entrada do bug corretamente. Especifique o prefixo do rastreador de problemas e o número do problema, separados por dois pontos, por exemplo, webrtc:123 ou chromium:12345 . Se você não tiver um prefixo de rastreador de problema e um número de problema, basta adicionar None .

    Salve e feche o arquivo para prosseguir com o upload para o servidor de revisão de código WebRTC.

    O comando imprimirá um link como https://webrtc-review.googlesource.com/c/src/+/53121 . se tudo correr bem.

• Clique neste link CL

• Se você não estiver conectado, clique no botão Sign In no canto superior direito e faça login com seu e-mail

• Clique em Iniciar revisão e adicione um revisor. Você pode encontrar revisores nos arquivos OWNERS no repositório (pegue aquele mais próximo de suas alterações)

• Aborde qualquer comentário do revisor:

  • Faça alterações, crie localmente, execute testes localmente
    • git commit -am "Fixed X and Y"
    • git cl upload

• Uma vez que o revisor LGTMs (aprova) o patch, peça a eles para colocá-lo na fila de confirmação

AVISO: No Windows, você precisará executar o comando acima em um shell bash Git para que o gclient encontre o arquivo .gitcookies .

Trybots

Se você está trabalhando muito no WebRTC, pode solicitar os direitos de teste . Isso significa que você pode executar o trybots , que executa todos os testes em todas as plataformas. Para fazer isso, registre um bug em bugs.webrtc.org e peça para a equipe EngProd conceder a você os direitos de tentativa.

Para executar um tryjob, carregue um CL conforme descrito acima e clique em simulação de CQ ou Escolha Trybots na IU Gerrit. Você precisa ter direitos de teste para isso. Caso contrário, peça ao seu revisor para lançar os bots para você.