Contribuir com o Bazel

Informar um problema Acessar fonte

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

Enviar feedback

Ao usar o Bazel, talvez você encontre alguns recursos que podem ser melhorados. Você pode informar 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. Também é possível informar problemas na página que você está visualizando 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:

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 para o ecossistema do Bazel:

  • Ajudar os mantenedores de regras contribuindo com solicitações de envio.
  • Criar novas regras e ter o código aberto.
  • contribuir para ferramentas relacionadas ao Bazel, por exemplo, ferramentas de migração;
  • Melhoria na integração do Bazel com outros ambientes de desenvolvimento integrado e ferramentas.

Antes de fazer uma mudança, crie um problema no GitHub (em inglês) ou envie um e-mail para bazel-discuss@.

As contribuições mais úteis corrigem bugs ou adicionam recursos, em vez de mudanças estilísticas, refatoração ou "limpeza". A mudança precisa incluir testes e documentação, considerando a compatibilidade com versões anteriores, a portabilidade e o impacto no uso e no desempenho da memória.

Para saber mais sobre como enviar uma mudança, consulte o processo de aceitação de 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 de base de código para mais detalhes.

O Bazel é organizado da seguinte maneira:

  • 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 integradas estão em com.google.devtools.build.lib.rules e com.google.devtools.build.lib.bazel.rules. Leia sobre os Desafios de regras de escrita primeiro.
  • As interfaces nativas do Java estão em src/main/native.
  • Várias ferramentas de suporte a linguagens são descritas na lista da seção compilação do Bazel.

Como pesquisar o código-fonte do Bazel

Para pesquisar rapidamente o código-fonte do Bazel, use a Pesquisa de código do Bazel. Você pode navegar pelos repositórios, ramificações e arquivos do Bazel. Você também pode ver informações de histórico, diferenças e culpabilização. Para saber mais, consulte o Guia do usuário da Pesquisa de código do Bazel (link em inglês).