Contribuir com o Bazel

Informar um problema Mostrar fonte Por noite · 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 melhoradas. 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 pouco clara. Você também pode informar problemas da página que você está visualizando. Para isso, use a opção "Criar problema" no canto superior direito da página.
  • Uma mensagem de erro pode ser melhorada.

Participe da comunidade

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

Contribuir com código

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

Você pode contribuir com o ecossistema do Bazel da seguinte forma:

  • ajudar os mantenedores de regras contribuindo com 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 alteração, crie um problema ou envie um e-mail para bazel-dev@.

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 do patch.

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.
    • Código principal que é composto principalmente por 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 estão descritas na lista do seção como compilar o Bazel.

Como pesquisar o código-fonte do Bazel

Para pesquisar rapidamente o código-fonte do Bazel, use Pesquisa de código do Bazel. É possível navegar pelas repositórios, ramificações e arquivos. Também é possível visualizar o histórico, as diferenças e os culpados informações imprecisas ou inadequadas. Para saber mais, consulte a Guia do usuário do Bazel Code Search (em inglês).