Contrato de licença
O WebRTC aceita patches/pulls para recursos e correções de bugs.
Para colaboradores externos ao Google, siga as instruções fornecidas no Contrato de licença de colaborador individual do Google. Em todos os casos, os colaboradores precisam assinar um contrato de licença de colaborador antes que uma contribuição possa ser aceita. Preencha o contrato para uma pessoa ou uma empresa, conforme necessário.
Como contribuir com amostras
Se você planeja adicionar uma nova amostra ou fazer mudanças significativas em uma amostra existente, recomendamos que comece criando um novo problema para discutirmos os detalhes.
Ao criar uma nova amostra ou atualizar uma existente, crie ou atualize também os testes. Todos os testes nesse repositório são implementados como testes de interface do Nightwatch.JS. Siga o mesmo design no seu repositorio.
Instruções
Como contribuir com seu primeiro patch
Você precisa fazer algumas preparações para fazer upload da primeira CL:
- Conferir e criar o código
- Preencha o contrato de colaborador (veja acima)
- Se você nunca enviou código antes, adicione seu nome e informações de contato (ou da sua organização, caso o contrato de colaborador seja assinado por ela) ao arquivo AUTHORS.
- Acesse
https://webrtc.googlesource.com/new-password
e faça login com sua conta de e-mail. Essa precisa ser a mesma conta
retornada por
git config user.email. - Depois, execute
git cl creds-check. Se você receber erros, peça ajuda no discuss-webrtc.
Não é necessário repetir o processo acima. Depois disso, você pode fazer o upload:
Como fazer upload do primeiro patch
Agora que você configurou sua conta, é possível fazer o upload:
Faça isto:
- Supondo que você esteja na ramificação principal:
git checkout -b my-work-branch
Fazer alterações, criar localmente e executar testes localmente
git commit -am "Changed x, and it is working"git cl upload
Isso vai abrir um editor de texto mostrando todas as mensagens de confirmação locais, permitindo que você as modifique antes que elas se tornem a descrição da CL.
Preencha a entrada de bug corretamente. Especifique o prefixo do rastreador de problemas e o número do problema, separados por dois pontos, por exemplo,
webrtc:123ouchromium:12345. Se você não tiver um prefixo do rastreador de problemas e um número de problema, adicioneNone.Salve e feche o arquivo para continuar o upload para o servidor de análise de código do WebRTC.
O comando vai mostrar um link como https://webrtc-review.googlesource.com/c/src/+/53121 se tudo correr bem.
- Supondo que você esteja na ramificação principal:
Clique neste link
Se você não estiver conectado, clique no botão "Fazer login" no canto superior direito e faça login com seu e-mail.
Clique em "Iniciar análise" e adicione um revisor. É possível encontrar revisores nos arquivos OWNERS no repositório (use o mais próximo das suas mudanças)
Responda a qualquer feedback do revisor:
- Fazer alterações, criar localmente e executar testes localmente
git commit -am "Fixed X and Y"git cl upload
- Fazer alterações, criar localmente e executar testes localmente
Depois que o revisor LGTM (aprovar) o patch, peça para colocá-lo na fila de confirmação.
AVISO: no Windows, será necessário executar o comando acima em um shell do bash do Git para que o gclient encontre o arquivo .gitcookies.
Trybots
Se você estiver trabalhando muito com o WebRTC, poderá solicitar direitos de teste. Isso significa que você pode executar os trybots, que executam todos os testes em todas as plataformas. Para fazer isso, registre um bug em bugs.webrtc.org e peça à equipe de EngProd para conceder direitos de teste.
Para executar um tryjob, faça upload de um CL conforme descrito acima e clique em CQ dry run ou Choose Trybots na interface do Gerrit. Você precisa ter direitos de teste para isso. Caso contrário, peça ao revisor para iniciar os bots para você.