Como instalar o Bazel no Windows

Esta página descreve os requisitos e as etapas para instalar o Bazel no Windows. Ela também inclui a solução de problemas e outras maneiras de instalar o Bazel, como usar o Chocolatey ou o Scoop.

Instalar o Bazel

Esta seção aborda os pré-requisitos, a configuração do ambiente e as etapas detalhadas durante a instalação no Windows.

Verificar o sistema

Recomendado: Windows 10 de 64 bits, versão 1703 (Creators Update) ou mais recente

Para verificar a versão do Windows:

• Clique no botão "Iniciar".
• Digite winver na caixa de pesquisa e pressione Enter.
• A caixa "Sobre o Windows" vai aparecer com as informações da versão do Windows.

Instalar os pré-requisitos

• Microsoft Visual C++ Redistributable

Fazer o download do Bazel

Recomendado: usar o Bazelisk

Como alternativa, você pode:

• Fazer o download do binário do Bazel (bazel-version-windows-x86_64.exe) no GitHub.
• Instalar o Bazel no Chocolatey
• Instalar o Bazel no Scoop
• Criar o Bazel a partir da origem

Configurar o ambiente

Para facilitar o acesso ao Bazel nos prompts de comando ou no PowerShell por padrão, renomeie o binário do Bazel para bazel.exe e adicione-o aos caminhos padrão.

set PATH=%PATH%;path to the Bazel binary

Você também pode mudar a variável de ambiente PATH do sistema para torná-la permanente. Saiba como definir variáveis de ambiente.

Concluído

"Sucesso: você instalou o Bazel."

Para verificar se a instalação está correta, tente executar:

bazel version

Em seguida, confira mais dicas e orientações aqui:

• Instalar compiladores e ambientes de execução de linguagem
• Solução de problemas
• Práticas recomendadas no Windows
• Tutoriais

Instalar compiladores e ambientes de execução de linguagem

Dependendo dos idiomas que você quer criar, será necessário:

• MSYS2 x86_64

  O MSYS2 é uma distribuição de software e uma plataforma de criação para Windows. Ele contém o Bash e ferramentas comuns do Unix (como grep, tar, git).

  Você vai precisar do MSYS2 para criar, testar ou executar destinos que dependem do Bash. Normalmente, eles são genrule, sh_binary, sh_test, mas pode haver mais (como regras do Starlark). O Bazel mostra um erro se um destino de build precisar do Bash, mas o Bazel não conseguir encontrá-lo.

• Pacotes comuns do MSYS2

  É provável que você precise deles para criar e executar destinos que dependem do Bash. O MSYS2 não instala essas ferramentas por padrão. Portanto, é necessário instalá-las manualmente. Projetos que dependem de ferramentas do Bash em PATH precisam dessa etapa (por exemplo, o TensorFlow).

  Abra o terminal do MSYS2 e execute este comando:

  pacman -S zip unzip patch diffutils git

  Opcional: se você quiser usar o Bazel no CMD ou no PowerShell e ainda conseguir usar as ferramentas do Bash, adicione MSYS2_INSTALL_PATH/usr/bin à sua PATH variável de ambiente.

• Ferramentas de build para Visual Studio 2019

  Você vai precisar disso para criar código C++ no Windows.

  Também há suporte para:

  • Ferramentas de build do Visual C++ 2017 (ou mais recente) e SDK do Windows 10

• Kit de desenvolvimento Java SE 11 (JDK) para Windows x64

  Você vai precisar disso para criar código Java no Windows.

  Também há suporte para: Java 8, 9 e 10

• Python 3.6 para Windows x86-64

  Você vai precisar disso para criar código Python no Windows.

  Também há suporte para: Python 2.7 ou mais recente para Windows x86-64

Solução de problemas

O Bazel não encontra o Bash ou o bash.exe

Motivos possíveis:

• Você instalou o MSYS2 em um caminho de instalação diferente do padrão

• Você instalou o MSYS2 i686 em vez do MSYS2 x86_64

• Você instalou o MSYS em vez do MSYS2

Solução:

Verifique se você instalou o MSYS2 x86_64.

Se isso não ajudar:

1. Acesse "Menu Iniciar" > "Configurações".

2. Encontre a configuração "Editar variáveis de ambiente da sua conta".

3. Confira a lista na parte de cima ("Variáveis de usuário para <nome de usuário>") e clique no botão "Novo..." abaixo dela.

4. Em "Nome da variável", insira BAZEL_SH

5. Clique em "Procurar arquivo..."

6. Navegue até o diretório do MSYS2 e depois para usr\bin abaixo dele.

   Por exemplo, esse caminho pode ser C:\msys64\usr\bin no seu sistema.

7. Selecione o arquivo bash.exe ou bash e clique em "OK".

8. O campo "Valor da variável" agora tem o caminho para bash.exe. Clique em "OK" para fechar a janela.

9. Pronto.

   Se você abrir um novo terminal cmd.exe ou PowerShell e executar o Bazel agora, ele vai encontrar o Bash.

O Bazel não encontra o Visual Studio ou o Visual C++

Motivos possíveis:

• Você instalou várias versões do Visual Studio

• Você instalou e removeu várias versões do Visual Studio

• Você instalou várias versões do SDK do Windows

• Você instalou o Visual Studio em um caminho de instalação diferente do padrão

Solução:

1. Acesse "Menu Iniciar" > "Configurações".

2. Encontre a configuração "Editar variáveis de ambiente da sua conta".

3. Confira a lista na parte de cima ("Variáveis de usuário para <nome de usuário>") e clique no botão "Novo..." abaixo dela.

4. Em "Nome da variável", insira BAZEL_VC

5. Clique em "Procurar diretório..."

6. Navegue até o diretório VC do Visual Studio.

   Por exemplo, esse caminho pode ser C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\VC no seu sistema.

7. Selecione a pasta VC e clique em "OK".

8. O campo "Valor da variável" agora tem o caminho para VC. Clique em "OK" para fechar a janela.

9. Pronto.

   Se você abrir um novo terminal cmd.exe ou PowerShell e executar o Bazel agora, ele vai encontrar o Visual C++.

Outras maneiras de instalar o Bazel

Usar o Chocolatey

1. Instale o Chocolatey gerenciador de pacotes

2. Instale o pacote do Bazel:

   choco install bazel

   Esse comando instala a versão mais recente disponível do Bazel e das dependências dele, como o shell do MSYS2. No entanto, ele não instala o Visual C++

Consulte o guia de instalação e manutenção de pacotes do Chocolatey para mais informações sobre o pacote do Chocolatey.

Usar o Scoop

1. Instale o Scoop gerenciador de pacotes usando o seguinte comando do PowerShell:

   iex (new-object net.webclient).downloadstring('https://get.scoop.sh')

2. Instale o pacote do Bazel:

   scoop install bazel

Consulte o guia de instalação e manutenção de pacotes do Scoop para mais informações sobre o pacote do Scoop.

Criar a partir da origem

Para criar o Bazel do zero em vez de instalar, consulte Como compilar a partir da origem.