Como instalar o Bazel no Windows

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

Como 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 sua versão do Windows.

Instalar os pré-requisitos

• Microsoft Visual C++ Redistribuível

Baixar o Bazel

Recomendado: use o Bazelisk

Como alternativa, você pode:

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

Configurar o ambiente

Para facilitar o acesso ao Bazel nos comandos ou no PowerShell por padrão, renomeie o binário do Bazel para bazel.exe e adicione-o aos seus 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:

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

Como instalar compiladores e ambientes de execução de linguagem

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

• MSYS2 x86_64

  O MSYS2 é uma distribuição de software e uma plataforma de criação para Windows. Ele contém 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, são genrule, sh_binary e sh_test, mas pode haver mais (como regras do Starlark). O Bazel mostra um erro se um destino de build precisar do Bash, mas não for possível localizá-lo.

• Pacotes comuns do MSYS2

  Você provavelmente vai precisar 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, TensorFlow).

  Abra o terminal 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 ferramentas do Bash, adicione MSYS2_INSTALL_PATH/usr/bin à variável de ambiente PATH.

• Ferramentas de build para Visual Studio 2019

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

  Também aceitamos:

  • 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 compatível com 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 compatível: 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 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 MSYS2 e depois até usr\bin abaixo dele.

   Por exemplo, 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 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, 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

Como usar o Chocolatey

1. Instale o gerenciador de pacotes Chocolatey.

2. Instale o pacote do Bazel:

   choco install bazel

   Esse comando instala a versão mais recente disponível do Bazel e as dependências dele, como o shell MSYS2. Isso não vai instalar o Visual C++.

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

Como usar o Scoop

1. Instale o gerenciador de pacotes Scoop 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 do Scoop e manutenção de pacotes para mais informações sobre o pacote Scoop.

Criar a partir da fonte

Para criar o Bazel do zero em vez de instalar, consulte Compilar da origem.