Como instalar o Bazel no Windows

Informar um problema Acessar a origem

Nesta página, descrevemos os requisitos e as etapas para instalar o Bazel no Windows. Ele também inclui solução de problemas e outras maneiras de instalar o Bazel, como usando Chocolatey ou 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 (atualização para criadores de conteúdo) ou mais recente

Para verificar a versão do Windows, faça o seguinte:

  • 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 de versão do Windows.

Instale os pré-requisitos

Fazer o download do Bazel

Recomendado: use o Bazelisk.

Você também pode fazer o seguinte:

configure seu ambiente

Para facilitar o acesso ao Bazel pelos prompts de comando ou pelo PowerShell por padrão, você pode renomear o binário do Bazel como bazel.exe e adicioná-lo aos seus caminhos padrão.

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

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

Concluído

"Concluído: 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 de linguagem

Dependendo das linguagens que você quer criar, é necessário ter:

  • MSYS2 x86_64

    O MSYS2 é uma plataforma de criação e distribuição de software 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, eles são genrule, sh_binary e sh_test, mas pode haver mais, como as regras do Starlark. O Bazel mostra um erro se um destino de build precisa do Bash, mas não é possível encontrá-lo.

  • Pacotes MSYS2 comuns

    Você provavelmente precisará deles para criar e executar destinos que dependam de Bash. Por padrão, o MSYS2 não instala essas ferramentas. Portanto, é necessário instalá-las manualmente. Os projetos que dependem de ferramentas 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 do CMD ou do PowerShell e ainda poder usar ferramentas Bash, adicione MSYS2_INSTALL_PATH/usr/bin à sua variável de ambiente PATH.

  • Ferramentas de build para Visual Studio 2019 (link em inglês)

    Você precisará dele para criar o código C++ no Windows.

    Também há suporte para:

    • Ferramentas de build do Visual C++ 2017 (ou mais recentes) e SDK do Windows 10
  • Kit de desenvolvimento Java SE 11 (JDK) para Windows x64

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

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

  • Python 3.6 para Windows x86-64

    Você precisará dele para criar o 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 ou bash.exe

Possíveis motivos:

  • você instalou MSYS2 não no caminho de instalação padrão

  • você instalou MSYS2 i686 em vez de MSYS2 x86_64

  • você instalou MSYS em vez de MSYS2

Solução:

Verifique se você instalou o MSYS2 x86_64.

Se isso não ajudar:

  1. Acesse o menu Iniciar > Configurações.

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

  3. Veja a lista na parte superior ("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 para usr\bin abaixo dele.

    Por exemplo, pode ser C:\msys64\usr\bin no 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 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

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

Solução:

  1. Acesse o menu Iniciar > Configurações.

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

  3. Veja a lista na parte superior ("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 "Browse Directory..."

  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 encontrará o Visual C++.

Outras maneiras de instalar o Bazel

Uso do 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 dele, como o shell MSYS2. Isso não instala o Visual C++.

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

Criar a partir da fonte

Para criar o Bazel do zero em vez de instalá-lo, consulte Como compilar a partir da origem.