Como instalar o Bazel
O Bazelisk é a maneira recomendada de instalar o Bazel no Ubuntu, Windows e macOS. Ele faz o download e a instalação automáticos da versão adequada do Bazel. Use o Bazelisk se você precisar alternar entre diferentes versões do Bazel, dependendo do diretório de trabalho atual ou para manter o Bazel sempre atualizado com a versão mais recente.
Para mais detalhes, consulte o README oficial.
Como atualizar o Bazel
O Bazel tem uma política de compatibilidade com versões anteriores. Consulte orientações para lançar mudanças incompatíveis se você for o autor de uma delas. Essa página resume as práticas recomendadas sobre como testar e migrar seu projeto com as próximas mudanças incompatíveis e como fornecer feedback aos autores da mudança incompatível.
Como gerenciar versões do Bazel com o Bazelisk
O Bazelisk ajuda a gerenciar versões do Bazel.
O Bazelisk pode:
- Atualização automática do Bazel para a versão LTS ou de lançamento mais recente.
- Crie o projeto com uma versão do Bazel especificada no arquivo .bazelversion. Faça o check-in desse arquivo no controle de versão para garantir a reprodutibilidade dos builds.
- Ajudar a migrar seu projeto para mudanças incompatíveis (veja acima)
- Testar facilmente as versões candidatas
Processo de migração recomendado
Em atualizações secundárias de qualquer versão LTS, qualquer projeto pode ser preparado para a próxima versão sem interromper a compatibilidade com a versão atual. No entanto, pode haver mudanças incompatíveis com versões anteriores entre as principais versões 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 mudanças incompatíveis precisam ter uma flag
--incompatible_*associada e um problema do GitHub correspondente:- As orientações de migração estão disponíveis no problema associado do GitHub.
- Há ferramentas disponíveis para algumas migrações de mudanças incompatíveis. Por exemplo, buildifier.
- Informe problemas de migração comentando no problema associado do GitHub.
Após a migração, você pode continuar criando seus projetos sem se preocupar com compatibilidade com versões anteriores até a próxima versão principal.