Como instalar o Bazel no Windows

Nesta página, descrevemos os requisitos e as etapas para instalar o Bazel no Windows. Ela também inclui solução de problemas e outras maneiras de instalar o Bazel, como 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.

Verifique seu 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.
  • Você verá a caixa Sobre o Windows com as informações da sua versão do Windows.

Instalar os pré-requisitos

Baixar o Bazel

Recomendado: use o Bazelisk

Também é possível fazer o seguinte:

Configure seu ambiente

Para facilitar o acesso do Bazel por comandos de comando ou pelo PowerShell por padrão, é possível renomear o binário dele como bazel.exe e adicioná-lo aos caminhos padrão.

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

Também é possível mudar a variável de ambiente PATH do sistema para torná-la permanente. Veja como definir variáveis de ambiente.

Concluído

"Pronto: você instalou o Bazel."

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

bazel version

A seguir, você pode conferir mais dicas e orientações aqui:

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

Dependendo das linguagens que você quer criar, serão necessários:

  • MSYS2 x86_64 (link em inglês)

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

    Você precisará do MSYS2 para criar, testar ou executar destinos que dependem do Bash. Normalmente, elas são genrule, sh_binary e sh_test, mas podem haver mais, como regras Starlark. O Bazel mostra um erro se um destino de build precisa do Bash, mas não consegue localizá-lo.

  • Pacotes MSYS2 comuns

    Você provavelmente 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. Os projetos que dependem de ferramentas Bash no PATH precisam dessa etapa (por exemplo, no 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 poder usar as ferramentas Bash, adicione MSYS2_INSTALL_PATH/usr/bin à variável de ambiente PATH.

  • Ferramentas de criação para o Visual Studio 2019

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

    Também compatíveis:

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

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

    Você precisará dele para criar código Java no Windows.

    Também compatíveis: Java 8, 9 e 10

  • Python 3.6 para Windows x86-64

    Você vai precisar dele 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 Bash nem bash.exe.

Possíveis motivos:

  • você instalou o MSYS2 não no caminho de instalação 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. Vá para o 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, em seguida, 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. Done.

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

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

Possíveis motivos:

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

  • 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 não no caminho de instalação padrão;

Solução:

  1. Vá para o 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 no diretório..."

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

    Por exemplo, ele 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. Done.

    Se você abrir um novo terminal cmd.exe ou do 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 instalará a versão mais recente disponível do Bazel e as dependências dela, como o shell MSYS2. No entanto, isso não instalará o Visual C++.

Consulte o guia de instalação e manutenção do pacote da Chocolatey (em inglês) para mais informações sobre o pacote.

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

Criar a partir da fonte

Para criar o Bazel do zero em vez de instalar, consulte Compilação da origem.