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 adequada do Bazel. Use o Bazelisk se você precisar alternar entre diferentes versões do Bazel dependendo do diretório de trabalho atual ou se quiser 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 enviar feedback aos autores dessas mudanças.
Como gerenciar versões do Bazel com o Bazelisk
O Bazelisk ajuda a gerenciar versões do Bazel.
O Bazelisk pode:
- Atualizar automaticamente o Bazel para a versão LTS ou Rolling 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ão para garantir a reprodutibilidade dos seus builds.
- Ajudar a migrar seu projeto para mudanças incompatíveis (veja acima)
- Teste 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 quebrar 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 receber conselhos sobre como migrar para a próxima versão.
- As principais mudanças incompatíveis precisam ter uma flag
--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 migrar algumas mudanças incompatíveis. Por exemplo, buildifier.
- Para informar problemas de migração, comente no problema associado do GitHub.
Após a migração, você pode continuar criando seus projetos sem se preocupar com a compatibilidade com versões anteriores até a próxima versão principal.