Como instalar / atualizar o Bazel usando o Bazelisk

Nightly · 9.1 · 9.0 · 8.6 · 8.5 · 8.4 · 8.3 · 8.2 · 8.1

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 para manter o Bazel sempre atualizado com a versão mais recente.

Para mais detalhes, consulte o arquivo README oficial.

Atualizar o Bazel

O Bazel tem uma política de compatibilidade com versões anteriores (consulte as orientações para lançar mudançasincompatí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 mudanças incompatíveis futuras e como fornecer feedback aos autores de mudanças incompatíveis.

Gerenciar versões do Bazel com o Bazelisk

O Bazelisk ajuda a gerenciar as versões do Bazel.

O Bazelisk pode:

  • Atualizar automaticamente o Bazel para a versão LTS ou de lançamento contínuo mais recente.
  • Criar 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 (consulte acima).
  • Testar facilmente as versões candidatas.

Processo de migração recomendado

Em atualizações secundárias para 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:

  1. Leia as notas da versão para receber orientações sobre como migrar para a próxima versão.
  2. As principais mudanças incompatíveis precisam ter uma flag --incompatible_* associada e um problema correspondente do GitHub:
    • As orientações de migração estão disponíveis no problema associado do GitHub.
    • As ferramentas estão disponíveis para algumas migrações de mudanças incompatíveis. Por exemplo, o Buildifier.
    • Informe problemas de migração comentando o 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.