Como compilar o Bazel a partir da origem

Esta página descreve como instalar o Bazel da origem e oferece dicas de solução de problemas comuns.

Para criar o Bazel da origem, faça uma destas ações:

Criar o Bazel usando o Bazel

Resumo

  1. Acesse a versão mais recente do Bazel na página de versões do GitHub ou com o Bazelisk.

  2. Faça o download das origens do Bazel no GitHub e extraia em algum lugar. Como alternativa, você pode clonar a árvore de origem do Git em https://github.com/bazelbuild/bazel.

  3. Instale os mesmos pré-requisitos do bootstrap (consulte para sistemas semelhantes ao Unix ou para Windows).

  4. Crie uma versão de desenvolvimento do Bazel usando o Bazel: bazel build //src:bazel-dev (ou bazel build //src:bazel-dev.exe no Windows).

  5. O binário resultante está em bazel-bin/src/bazel-dev (ou bazel-bin\src\bazel-dev.exe no Windows). É possível copiar para qualquer lugar e usar imediatamente sem instalação.

As instruções detalhadas estão abaixo.

Etapa 1: acessar a versão mais recente do Bazel

Objetivo: instalar ou fazer o download de uma versão do Bazel. Verifique se é possível executá-lo digitando bazel em um terminal.

Motivo: para criar o Bazel em uma árvore de origem do GitHub, você precisa de um binário do Bazel pré-existente. É possível instalar um de um gerenciador de pacotes ou fazer o download de um no GitHub. Consulte Instalar o Bazel. Ou você pode criar do zero (bootstrap).

Solução de problemas:

  • Se não for possível executar o Bazel digitando bazel em um terminal:

    • Talvez o diretório binário do Bazel não esteja no PATH.

      Esse não é um problema grande. Em vez de digitar bazel, você precisará digitar o caminho completo.

    • Talvez o binário do Bazel não seja chamado de bazel (em Unix) ou bazel.exe (no Windows).

      Esse não é um problema grande. É possível renomear o binário ou digitar o nome dele em vez de bazel.

    • Talvez o binário não seja executável (em Unix).

      É necessário tornar o binário executável executando chmod +x /path/to/bazel.

Etapa 2: fazer o download das origens do Bazel no GitHub

Se você estiver familiarizado com o Git, basta clonar https://github.com/bazelbuild/bazel.

Se esse não for seu caso, faça o seguinte:

  1. Faça o download das origens mais recentes como um arquivo zip.

  2. Extraia o conteúdo em algum lugar.

    Por exemplo, crie um diretório bazel-src no diretório inicial e extraia o conteúdo.

Etapa 3: instalar os pré-requisitos

Instale os mesmos pré-requisitos do bootstrap (consulte abaixo): JDK, compilador C++, MSYS2 (se você estiver criando no Windows) etc.

Etapa 4a: criar o Bazel no Ubuntu Linux, macOS e outros sistemas semelhantes ao Unix

Para instruções do Windows, consulte Criar o Bazel no Windows.

Objetivo: executar o Bazel para criar um binário personalizado do Bazel (bazel-bin/src/bazel-dev).

Instruções:

  1. Inicie um terminal Bash.

  2. cd no diretório em que você extraiu (ou clonou) as origens do Bazel.

    Por exemplo, se você extraiu as origens no diretório inicial, execute:

    cd ~/bazel-src

  3. Crie o Bazel da origem:

    bazel build //src:bazel-dev

    Como alternativa, você pode executar bazel build //src:bazel --compilation_mode=opt para gerar um binário menor, mas a criação é mais lenta.

    É possível criar com a flag --stamp --embed_label=X.Y.Z para incorporar uma versão do Bazel ao binário para que bazel --version gere a versão especificada.

  4. A saída estará em bazel-bin/src/bazel-dev (ou bazel-bin/src/bazel).

Etapa 4b: criar o Bazel no Windows

Para instruções de sistemas semelhantes ao Unix, consulte Ubuntu Linux, macOS e outros sistemas semelhantes ao Unix.

Objetivo: executar o Bazel para criar um binário personalizado do Bazel (bazel-bin\src\bazel-dev.exe).

Instruções:

  1. Inicie o prompt de comando (menu Iniciar > Executar > "cmd.exe").

  2. cd no diretório em que você extraiu (ou clonou) as origens do Bazel.

    Por exemplo, se você extraiu as origens no diretório inicial, execute:

    cd %USERPROFILE%\bazel-src

  3. Crie o Bazel da origem:

    bazel build //src:bazel-dev.exe

    Como alternativa, você pode executar bazel build //src:bazel.exe --compilation_mode=opt para gerar um binário menor, mas a criação é mais lenta.

    É possível criar com a flag --stamp --embed_label=X.Y.Z para incorporar uma versão do Bazel ao binário para que bazel --version gere a versão especificada.

  4. A saída estará em bazel-bin\src\bazel-dev.exe (ou bazel-bin\src\bazel.exe).

Etapa 5: instalar o binário criado

Na verdade, não há nada para instalar.

A saída da etapa anterior é um binário do Bazel independente. É possível copiar para qualquer diretório e usar imediatamente. Isso é útil se o diretório estiver no PATH para que você possa executar "bazel" em qualquer lugar.

Criar o Bazel do zero (bootstrap)

Também é possível criar o Bazel do zero, sem usar um binário do Bazel.

Etapa 1: fazer o download das origens do Bazel (arquivo de distribuição)

Essa etapa é a mesma para todas as plataformas.

  1. Faça o download de bazel-<version>-dist.zip no GitHub, por exemplo bazel-0.28.1-dist.zip.

    Atenção:

    • Há um único arquivo de distribuição independente da arquitetura. Não há arquivos de distribuição específicos da arquitetura ou do SO.
    • Essas origens não são as mesmas da árvore de origem do GitHub. É necessário usar o arquivo de distribuição para inicializar o Bazel. Não é possível usar uma árvore de origem clonada do GitHub. O arquivo de distribuição contém arquivos de origem gerados que são necessários para o bootstrap e não fazem parte da árvore de origem normal do Git.

  2. Descompacte o arquivo de distribuição em algum lugar no disco.

    Verifique a assinatura feita pela chave de lançamento do Bazel 3D5919B448457EE0.

Etapa 2a: inicializar o Bazel no Ubuntu Linux, macOS e outros sistemas semelhantes ao Unix

Para instruções do Windows, consulte Inicializar o Bazel no Windows.

2.1. Instalar os pré-requisitos

  • Bash

  • zip, unzip

  • Cadeia de ferramentas de build C++

  • JDK. A versão 21 é necessária.

  • Python. As versões 2 e 3 são compatíveis. A instalação de uma delas é suficiente.

Por exemplo, no Ubuntu Linux, é possível instalar esses requisitos usando o comando a seguir:

sudo apt-get install build-essential openjdk-21-jdk python zip unzip

2.2. Inicializar o Bazel no Unix

  1. Abra uma janela de shell ou terminal.

  2. cd no diretório em que você descompactou o arquivo de distribuição.

  3. Execute o script de compilação: env EXTRA_BAZEL_ARGS="--tool_java_runtime_version=local_jdk" bash ./compile.sh.

A saída compilada é colocada em output/bazel. Esse é um binário do Bazel independente, sem um JDK incorporado. É possível copiar para qualquer lugar ou usar no local. Para sua conveniência, copie esse binário para um diretório que esteja no seu PATH (como /usr/local/bin no Linux).

Para criar o binário bazel de maneira reproduzível, defina também SOURCE_DATE_EPOCH na etapa "Executar o script de compilação".

Etapa 2b: inicializar o Bazel no Windows

Para instruções de sistemas semelhantes ao Unix, consulte Inicializar o Bazel no Ubuntu Linux, macOS e outros sistemas semelhantes ao Unix.

2.1. Instalar os pré-requisitos

2.2. Inicializar o Bazel no Windows

  1. Abra o shell do MSYS2.

  2. Configure as variáveis de ambiente a seguir:

    • BAZEL_VS ou BAZEL_VC (eles não são iguais): defina o caminho para o diretório do Visual Studio (BAZEL_VS) ou para o diretório do Visual C++ (BAZEL_VC). Definir um deles é suficiente.

    • BAZEL_SH: caminho do MSYS2 bash.exe. Consulte o comando nos exemplos abaixo.

      Não defina como C:\Windows\System32\bash.exe. Você tem esse arquivo se instalou o Subsistema do Windows para Linux. O Bazel não oferece suporte a essa versão do bash.exe.

    • PATH: adicione o diretório do Python.

    • JAVA_HOME: defina o diretório JDK.

    Exemplo (usando BAZEL_VS):

    export BAZEL_VS="C:/Program Files (x86)/Microsoft Visual Studio/2017/BuildTools"
export BAZEL_SH="$(cygpath -m $(realpath $(which bash)))"
export PATH="/c/python27:$PATH"
export JAVA_HOME="C:/Program Files/Java/jdk-21"

    ou (usando BAZEL_VC):

    export BAZEL_VC="C:/Program Files (x86)/Microsoft Visual Studio/2017/BuildTools/VC"
export BAZEL_SH="$(cygpath -m $(realpath $(which bash)))"
export PATH="/c/python27:$PATH"
export JAVA_HOME="C:/Program Files/Java/jdk-21"

  3. cd no diretório em que você descompactou o arquivo de distribuição.

  4. Execute o script de compilação: env EXTRA_BAZEL_ARGS="--tool_java_runtime_version=local_jdk" ./compile.sh

A saída compilada é colocada em output/bazel.exe. Esse é um binário do Bazel independente, sem um JDK incorporado. É possível copiar para qualquer lugar ou usar no local. Para sua conveniência, copie esse binário para um diretório que esteja no seu PATH.

Para criar o binário bazel.exe de maneira reproduzível, defina também SOURCE_DATE_EPOCH na etapa "Executar o script de compilação".

Não é necessário executar o Bazel no shell do MSYS2. É possível executar o Bazel no prompt de comando (cmd.exe) ou no PowerShell.