Como instalar o Bazel
O Bazelisk é a maneira recomendada de instalar o Bazel no Ubuntu, Windows e macOS. Ele faz o download e instala automaticamente a versão apropriada do Bazel. Use o Bazelisk se precisar alternar entre diferentes versões, dependendo do diretório de trabalho atual, ou para manter o Bazel 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 as orientações para implantar mudanças incompatíveis se você for o autor de uma. Nessa página, resumimos 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 das mudanças incompatíveis.
Como gerenciar versões do Bazel com o Bazelisk
O Bazelisk ajuda a gerenciar versões do Bazel.
O Bazelisk pode:
- Atualize automaticamente o Bazel para o LTS mais recente ou a versão contínua.
- Crie o projeto com uma versão do Bazel especificada no arquivo .bazelversion. Inclua esse arquivo no controle de versões para garantir a reprodutibilidade dos builds.
- Ajuda para migrar seu projeto em busca de mudanças incompatíveis (consulte acima)
- Tentar candidatas a lançamento facilmente
Processo de migração recomendado
Em pequenas atualizações 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 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 receber orientações sobre como migrar para a próxima versão.
- Grandes mudanças 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.
- As ferramentas estão disponíveis para algumas das migrações de mudanças incompatíveis. Por exemplo, buildifier.
- Informe problemas de migração comentando o problema associado do GitHub.
Após a migração, você pode continuar a criar seus projetos sem se preocupar com a compatibilidade com versões anteriores até a próxima versão principal.