En esta página, se describe cómo instalar Bazel en macOS y configurar tu entorno.
Puedes instalar Bazel en macOS con uno de los siguientes métodos:
- Recomendado: Usa Bazelisk
- Cómo usar Homebrew
- Cómo usar el instalador binario
- Cómo compilar Bazel desde la fuente
Bazel incluye dos secuencias de comandos de finalización. Después de instalar Bazel, puedes hacer lo siguiente:
- Accede a la secuencia de comandos de finalización de Bash.
- Instala la secuencia de comandos de finalización de zsh.
Cómo instalar con Homebrew
Paso 1: Instala Homebrew en macOS
Instala Homebrew (un paso único):
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
Paso 2: Instala Bazel a través de Homebrew
Instala el paquete de Bazel a través de Homebrew de la siguiente manera:
brew install bazel
¡Todo listo! Para confirmar que Bazel se instaló correctamente, ejecuta el siguiente comando:
bazel --version
Una vez instalado, puedes actualizar a una versión más reciente de Bazel con el siguiente comando:
brew upgrade bazel
Cómo instalar con el instalador binario
Los instaladores binarios se encuentran en la página de versiones de GitHub de Bazel.
El instalador contiene el objeto binario de Bazel. También se deben instalar algunas bibliotecas adicionales para que Bazel funcione.
Paso 1: Instala las herramientas de línea de comandos de Xcode
Si no tienes la intención de usar reglas de ios_*
, es suficiente con instalar el paquete de herramientas de línea de comandos de Xcode con xcode-select
:
xcode-select --install
De lo contrario, para admitir la regla ios_*
, debes tener Xcode 6.1 o una versión posterior con el SDK de iOS 8.1 instalado en tu sistema.
Descarga Xcode desde App Store o el sitio para desarrolladores de Apple.
Una vez que se instale Xcode, acepta el contrato de licencia para todos los usuarios con el siguiente comando:
sudo xcodebuild -license accept
Paso 2: Descarga el instalador de Bazel
A continuación, descarga el instalador binario de Bazel llamado bazel-<version>-installer-darwin-x86_64.sh
desde la página de versiones de Bazel en GitHub.
En macOS Catalina o versiones posteriores (macOS >= 11), debido a los nuevos requisitos de firma de apps de Apple, debes descargar el instalador desde la terminal con curl
y reemplazar la variable de versión por la versión de Bazel que deseas descargar:
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 es una solución temporal hasta que el flujo de lanzamiento de macOS admita la firma (#9304).
Paso 3: Ejecuta el instalador
Ejecuta el instalador de Bazel de la siguiente manera:
chmod +x "bazel-$BAZEL_VERSION-installer-darwin-x86_64.sh"
./bazel-$BAZEL_VERSION-installer-darwin-x86_64.sh --user
La marca --user
instala Bazel en el directorio $HOME/bin
de tu sistema y
configura la ruta de acceso .bazelrc
en $HOME/.bazelrc
. Usa el comando --help
para ver opciones de instalación adicionales.
Si usas macOS Catalina o una versión posterior (macOS >= 11) y recibes un error que indica que no se puede abrir “bazel-real” porque no se puede verificar el desarrollador, debes volver a descargar el instalador desde la terminal con curl
como solución alternativa. Consulta el paso 2 anterior.
Paso 4: Configura tu entorno
Si ejecutaste el instalador de Bazel con la marca --user
como se indicó anteriormente, el ejecutable de Bazel se instalará en el directorio HOME/bin
.
Te recomendamos que agregues este directorio a tus rutas de acceso predeterminadas de la siguiente manera:
export PATH="PATH:HOME/bin"
También puedes agregar este comando a tu archivo ~/.bashrc
, ~/.zshrc
o ~/.profile
.
¡Todo listo! Para confirmar que Bazel se instaló correctamente, ejecuta el siguiente comando:
bazel --version
Para actualizar Bazel a una versión más reciente, descarga e instala la versión que desees.