Como instalar o Bazel
Bazelisk é a recomendada de instalar o Bazel no Ubuntu, Windows e macOS. Ele automaticamente faz o download e instala a versão apropriada do Bazel. Use o Bazelisk se você precisa alternar entre diferentes versões do Bazel dependendo da configuração diretório de trabalho, ou manter o Bazel atualizado para a versão mais recente.
Para mais detalhes, consulte o README oficial (em inglês).
Como atualizar o Bazel
O Bazel tem uma política de compatibilidade com versões anteriores. (consulte as orientações para o lançamento de modelos de mudanças se você são os autores de um deles). 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 para os autores das mudanças incompatíveis.
Como gerenciar versões do Bazel com o Bazelisk
O Bazelisk ajuda você a gerenciar 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 na versão .bazelversion. . Fazer 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 do LTS, o projeto possa ser preparado para o próximo lançamento sem quebrar 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 saber 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 a migração de algumas mudanças incompatíveis. Para exemplo, buildifier.
- Informe problemas de migração comentando o problema associado no GitHub.
Após a migração, é possível continuar criando projetos sem se preocupar com a compatibilidade com versões anteriores até o próximo lançamento principal.