Como instalar o Bazel
O Bazelisk (link em inglês) é a maneira recomendada de instalar o Bazel no Ubuntu, Windows e macOS. O download e a instalação da versão apropriada do Bazel são feitos automaticamente. Use o Bazelisk se precisar alternar entre diferentes versões dependendo do diretório de trabalho atual ou para sempre manter o Bazel atualizado para a versão mais recente.
Para mais detalhes, consulte o README oficial (link em inglês).
Como atualizar o Bazel
O Bazel tem uma política de compatibilidade com versões anteriores. Consulte as orientações para lançar mudanças incompatíveis se você for o autor de uma. Nesta página, resumimos as práticas recomendadas sobre como testar e migrar seu projeto com as próximas alterações incompatíveis e como fornecer feedback aos autores das alterações incompatíveis.
Como gerenciar versões do Bazel com o Bazelisk
O Bazelisk ajuda você a gerenciar as versões do Bazel.
O Bazelisk pode:
- Atualizar automaticamente o Bazel para a versão gradual ou LTS mais recente.
- Crie o projeto com uma versão do Bazel especificada no arquivo .bazelversion. Faça check-in desse arquivo no controle de versões para garantir a reprodutibilidade dos builds.
- Ajudar a migrar seu projeto em caso de mudanças incompatíveis (veja acima)
- Teste facilmente os candidatos a lançamento
Processo de migração recomendado
Em atualizações menores de qualquer versão LTS, qualquer projeto pode ser preparado para a próxima versão sem prejudicar a compatibilidade com a versão atual. No entanto, pode haver alterações incompatíveis com versões anteriores entre as principais versões do LTS.
Siga este processo para migrar de uma versão principal para outra:
- Leia as notas da versão para saber como migrar para a próxima versão.
- As principais alterações incompatíveis precisam ter uma sinalização
--incompatible_*
associada e um problema correspondente no GitHub:- As orientações de migração estão disponíveis no problema associado do GitHub.
- Há ferramentas disponíveis para a migração de algumas mudanças incompatíveis. Por exemplo, buildifier.
- Informe problemas de migração comentando o problema associado no GitHub.
Após a migração, é possível continuar criando seus projetos sem se preocupar com a compatibilidade com versões anteriores até a próxima versão principal.