Acordo de Licença
WebRTC agradece patches / pulls para recursos e correções de bugs!
Para colaboradores externos ao Google, siga as instruções contidas no Contrato de Licença do Google Individual Contributor . Em todos os casos, os contribuidores devem assinar um contrato de licença de contribuidor antes que uma contribuição possa ser aceita. Por favor, preencha o acordo para um indivíduo ou uma corporação , conforme apropriado.
Contribuindo com amostras
Se você pretende adicionar uma nova amostra ou fazer mudanças significativas a uma amostra existente, recomendamos que você começar criando uma nova edição onde podemos 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 submetido código antes, você deve adicionar o seu (ou sua organização está no caso do acordo de contribuição é assinado por sua organização) nome e informações de contato para o AUTORES arquivo
- Ir para https://webrtc.googlesource.com/new-password e login com sua conta de email. Esta deve ser a mesma conta como retornado por
git config user.email
- Em seguida, execute:
git cl creds-check
. Se você receber algum erro, pedir ajuda em discutir-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 principal:
-
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ê modifique antes que se torne a descrição do CL.
Preencha a entrada do bug corretamente. Por favor, especificar o prefixo questão rastreador e o número de emissão, separados por dois pontos, por exemplo
webrtc:123
ouchromium:12345
. Se você não tem um prefixo issue tracker e um número de emissão basta adicionarNone
.Salvar e fechar o arquivo para prosseguir com a transferência para o WebRTC servidor revisão de código .
O comando irá imprimir um link como https://webrtc-review.googlesource.com/c/src/+/53121 . se tudo correr bem.
-
- Supondo que você esteja no branch principal:
Clique neste link CL
Se você não estiver conectado, clique no botão Entrar 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
-
- Faça alterações, crie localmente, execute testes localmente
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ê precisa executar o acima em um shell bash Git para que GClient para encontrar o .gitcookies
arquivo.
Trybots
Se você está trabalhando muito em WebRTC, você pode aplicar para direitos tentativa. Isto significa que você pode executar os trybots, que funcionam 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ê.