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 do Bazel, dependendo do diretório de trabalho atual, ou sempre manter o Bazel atualizado para a versão mais recente.
Para mais detalhes, consulte o README oficial (em inglês).
Atualizando o Bazel
O Bazel tem uma política de compatibilidade com versões anteriores. Consulte as orientações sobre o lançamento de alterações incompatíveis se você for o autor de uma. Nesta página, você encontra um resumo das práticas recomendadas para testar e migrar projetos com futuras mudanças incompatíveis e como fornecer feedback aos autores incompatíveis.
Como gerenciar versões do Bazel com o Bazelisk
O Bazelisk ajuda a gerenciar as versões dele.
O Bazelisk pode:
- Atualize automaticamente o Bazel para a versão mais recente do LTS ou gradual.
- Crie o projeto com uma versão do Bazel especificada no arquivo .bazelversion. Verifique esse arquivo no controle de versões para garantir a reprodução dos builds.
- Ajudar a migrar seu projeto para alterações incompatíveis (veja acima)
- Facilite o lançamento de candidatos
Processo de migração recomendado
Em pequenas atualizações de qualquer versão de 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 mudanças 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 ver orientações sobre como migrar para a próxima versão.
- As principais mudanças incompatíveis devem ter uma sinalização
--incompatible_*associada e um problema do GitHub correspondente:- As orientações de migração estão disponíveis no problema do GitHub associado.
- As ferramentas estão disponíveis para algumas migrações incompatíveis de mudanças. Por exemplo, buildifier.
- Comunique o problema de migração comentando no problema associado do 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.