Esta página descreve como instalar o Bazel no macOS e configurar seu ambiente.
É possível instalar o Bazel no macOS usando um destes métodos:
O Bazel 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 preenchimento 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 pelo Homebrew
Instale o pacote Bazel pelo Homebrew da seguinte maneira:
brew install bazel
Tudo pronto! Para confirmar que o Bazel foi instalado, execute o seguinte comando:
bazel --version
Depois de instalar, é 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 lançamentos 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 à regra ios_*, você precisa ter o Xcode 6.1 ou mais recente com o SDK
do iOS 8.1 instalado no seu 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 (link em inglês).
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 fazer o download:
export BAZEL_VERSION=5.2.0curl -fLO "https://github.com/bazelbuild/bazel/releases/download/$BAZEL_VERSION/bazel-$BAZEL_VERSION-installer-darwin-x86_64.sh"
Essa é 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 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 usando o macOS Catalina ou mais recente (macOS >= 11) e receber um erro de que "bazel-real" não pode ser
aberto porque o desenvolvedor não pode ser verificado, será necessário fazer o download novamente
do instalador no 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, o executável
do Bazel será instalado no diretório HOME/bin.
É recomendável adicionar esse diretório aos caminhos padrão da seguinte maneira:
export PATH="PATH:HOME/bin"
Também é possível adicionar esse comando ao arquivo ~/.bashrc, ~/.zshrc ou ~/.profile.
Tudo pronto! Para confirmar que o Bazel foi instalado, execute o seguinte comando:
bazel --version
Para atualizar para uma versão mais recente do Bazel, faça o download e instale a versão desejada.