Como instalar o Bazel no macOS

Nesta página, descrevemos como instalar o Bazel no macOS e configurar seu ambiente.

É possível instalar o Bazel no macOS usando um dos seguintes métodos:

• Recomendado: use o Bazelisk
• Usar o Homebrew
• Usar o instalador binário
• Compilar o Bazel da origem

O Bazel vem com dois scripts de conclusão. Depois de instalar o Bazel, você pode:

• Acesse o script de conclusão do bash
• Instale o script de conclusão do zsh.

Como instalar usando o Homebrew

Etapa 1: instalar o Homebrew no macOS

Instale o Homebrew (uma etapa única):

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Etapa 2: instalar o Bazel usando o Homebrew

Instale o pacote do Bazel via Homebrew da seguinte maneira:

brew install bazel

Tudo pronto! Para confirmar se o Bazel foi instalado corretamente, execute o comando a seguir:

bazel --version

Depois de instalado, é possível fazer upgrade para uma versão mais recente do Bazel usando o seguinte comando:

brew upgrade bazel

Como instalar usando o instalador binário

Os instaladores binários estão na página de versões do GitHub do Bazel.

O instalador contém o binário do Bazel. Algumas bibliotecas adicionais também precisam ser instaladas para que o Bazel funcione.

Etapa 1: instalar as ferramentas de linha de comando do Xcode

Se você não pretende usar regras ios_*, basta instalar o pacote de ferramentas de linha de comando do Xcode usando xcode-select:

xcode-select --install

Caso contrário, para oferecer suporte a regras ios_*, é necessário ter o Xcode 6.1 ou mais recente com o SDK do iOS 8.1 instalado no sistema.

Faça o download do Xcode na App Store ou no site da Apple para desenvolvedores.

Depois que o Xcode for instalado, aceite o contrato de licença para todos os usuários com o seguinte comando:

sudo xcodebuild -license accept

Etapa 2: fazer o download do instalador do Bazel

Em seguida, faça o download do instalador binário do Bazel chamado bazel-<version>-installer-darwin-x86_64.sh na página de versões do Bazel no GitHub.

No macOS Catalina ou mais recente (macOS >= 11), devido aos novos requisitos de assinatura de apps da Apple, é necessário fazer o download do instalador no terminal usando curl, substituindo a variável de versão pela versão do Bazel que você quer baixar:

export BAZEL_VERSION=5.2.0
curl -fLO "https://github.com/bazelbuild/bazel/releases/download/$BAZEL_VERSION/bazel-$BAZEL_VERSION-installer-darwin-x86_64.sh"

Essa é uma solução alternativa temporária até que o fluxo de lançamento do macOS ofereça suporte à assinatura (#9304).

Etapa 3: executar o instalador

Execute o instalador do Bazel da seguinte maneira:

chmod +x "bazel-$BAZEL_VERSION-installer-darwin-x86_64.sh"
./bazel-$BAZEL_VERSION-installer-darwin-x86_64.sh --user

A flag --user instala o Bazel no diretório $HOME/bin do sistema e define o caminho .bazelrc como $HOME/.bazelrc. Use o comando --help para conferir outras opções de instalação.

Se você estiver no macOS Catalina ou mais recente (macOS >= 11) e receber um erro informando que não é possível abrir "bazel-real" porque não foi possível verificar o desenvolvedor, baixe novamente o instalador no terminal usando curl como solução alternativa. Consulte a etapa 2 acima.

Etapa 4: configurar seu ambiente

Se você executou o instalador do Bazel com a flag --user como acima, o executável do Bazel será instalado no diretório HOME/bin. É recomendável adicionar esse diretório aos seus caminhos padrão, da seguinte forma:

export PATH="PATH:HOME/bin"

Também é possível adicionar esse comando ao arquivo ~/.bashrc, ~/.zshrc ou ~/.profile.

Tudo pronto! Para confirmar se o Bazel foi instalado corretamente, execute o comando a seguir:

bazel --version

Para atualizar para uma versão mais recente do Bazel, baixe e instale a versão desejada.