Contribuir com o Bazel

Reportar um problema Ver código-fonte Nightly · 7.4 . 7.3 · 7.2 · 7.1 · 7.0 · 6.5

Há muitas maneiras de ajudar o projeto e o ecossistema do Bazel.

Enviar feedback

Ao usar o Bazel, você pode encontrar coisas que podem ser aprimoradas. Você pode ajudar informando problemas quando:

O Bazel falha ou você encontra um bug que só pode ser resolvido usando bazel clean.
A documentação está incompleta ou não é clara. Também é possível informar problemas na página em que você está usando o link "Criar problema" no canto superior direito da página.
Uma mensagem de erro pode ser melhorada.

Participar da comunidade

Você pode interagir com a comunidade do Bazel da seguinte forma:

Responda a perguntas no Stack Overflow.
Ajudar outros usuários no Slack.
melhorar a documentação ou contribuir com exemplos;
Compartilhar sua experiência ou dicas, por exemplo, em um blog ou mídias sociais.

Contribuir com código

O Bazel é um projeto grande, e fazer uma alteração no código-fonte dele pode ser difícil.

Você pode contribuir com o ecossistema do Bazel:

Ajudar os mantenedores de regras enviando solicitações de envio.
Criar novas regras e abrir o código delas.
Contribuir com ferramentas relacionadas ao Bazel, por exemplo, ferramentas de migração.
melhorar a integração do Bazel com outros ambientes de desenvolvimento integrado e ferramentas.

Antes de fazer uma mudança, crie um problema no GitHub ou envie um e-mail para bazel-discuss@.

As contribuições mais úteis corrigem bugs ou adicionam recursos, até estilística, refatoração ou "limpeza" muda). Sua alteração deve inclua testes e documentação, tendo em mente a compatibilidade com versões anteriores, à portabilidade e ao impacto no uso de memória e no desempenho.

Para saber como enviar uma mudança, consulte o processo de aceitação de patches.

Descrição do código do Bazel

O Bazel tem uma grande base de código com código em vários locais. Consulte o guia da base de código para saber mais.

Ele é organizado da seguinte forma:

O código do cliente está em src/main/cpp e fornece a interface de linha de comando.
Os buffers de protocolo estão em src/main/protobuf.
O código do servidor está em src/main/java e src/test/java.
- O código principal, que é composto principalmente de SkyFrame e alguns utilitários.
- As regras incorporadas estão em com.google.devtools.build.lib.rules e em com.google.devtools.build.lib.bazel.rules. Talvez você queira ler sobre Desafios de regras de escrita primeiro.
As interfaces nativas do Java estão em src/main/native.
Várias ferramentas de suporte a idiomas são descritas na lista da seção Compilação do Bazel.

Como pesquisar o código-fonte do Bazel

Para pesquisar rapidamente no código-fonte do Bazel, use a Bazel Code Search. É possível navegar pelas repositórios, ramificações e arquivos. Também é possível conferir o histórico, as diferenças e as informações de culpa. Para saber mais, consulte o Guia do usuário da Pesquisa de código do Bazel.