Nesta página, descrevemos como instalar o Bazel no macOS e configurar o ambiente.
Você pode instalar o Bazel no macOS usando um dos seguintes métodos:
- Recomendado: use o Bazelisk
- Usar o instalador binário
- Usar o Homebrew
- Compilar o Bazel usando a origem
Ele vem com dois scripts de conclusão. Depois de instalar o Bazel, você pode:
- Acesse o script de conclusão de bash.
- Instale o script de conclusão zsh.
Como fazer a instalação usando o instalador binário
Os instaladores binários estão Página de versões do GitHub.
O instalador contém o binário do Bazel. Algumas bibliotecas adicionais também precisam ser instalados para que o Bazel funcione.
Etapa 1: instalar as ferramentas de linha de comando do Xcode
Se você não pretende usar as regras ios_*
, basta instalar o Xcode.
pacote de ferramentas de linha de comando usando xcode-select
:
xcode-select --install
Caso contrário, para aceitar a regra ios_*
, você precisará ter o Xcode 6.1 ou posterior com iOS
SDK 8.1 instalado no sistema.
Baixe o Xcode no App Store ou a Site para desenvolvedores da Apple.
Depois de instalar o Xcode, 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
Depois, faça o download do instalador binário do Bazel chamado
bazel-<version>-installer-darwin-x86_64.sh
do
Página de versões do Bazel no GitHub (link em inglês).
No macOS Catalina ou mais recente (macOS >= 11), devido aos novos requisitos de assinatura de apps da Apple,
Baixe o instalador do terminal usando curl
, substituindo
a variável de versão com a 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"
Esta é uma solução 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
no sistema e
define o caminho .bazelrc
como $HOME/.bazelrc
. Use o comando --help
para ver
outras opções de instalação.
Se você estiver usando o macOS Catalina ou uma versão mais recente (macOS >= 11) e receber um erro informando que “bazel-real” não pode ser
estiver aberto porque o desenvolvedor não pode ser verificado, faça o download novamente
o instalador do terminal usando curl
como solução alternativa; consulte a Etapa 2 acima.
Etapa 4: configurar o ambiente
Se você executou o instalador do Bazel com a flag --user
como acima, a versão
O executável está instalado no diretório HOME/bin
.
É uma boa ideia adicionar esse diretório aos caminhos padrão, da seguinte maneira:
export PATH="PATH:HOME/bin"
Também é possível adicionar esse comando ao ~/.bashrc
, ~/.zshrc
ou ~/.profile
.
Tudo pronto! Para confirmar se o Bazel foi instalado corretamente, execute o comando seguinte comando:
bazel --version
Para atualizar para uma versão mais recente do Bazel, faça o download e instale a versão desejada.
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/master/install.sh)"
Etapa 2: instalar o Bazel via 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 seguinte comando:
bazel --version
Depois de instalado, é possível fazer upgrade para uma versão mais recente do Bazel usando o seguinte comando:
brew upgrade bazel