Cómo instalar Bazel
Bazelisk es la forma recomendada de instalar Bazel en Ubuntu, Windows y macOS. Descarga e instala automáticamente la versión adecuada de Bazel. Usa Bazelisk si necesitas cambiar entre diferentes versiones de Bazel según el directorio de trabajo actual o si quieres mantener Bazel siempre actualizado a la versión más reciente.
Para obtener más detalles, consulta el archivo readme oficial.
Cómo actualizar Bazel
Bazel tiene una política de retrocompatibilidad (consulta la guía para lanzar cambios incompatibles si eres el autor de uno). En esa página, se resumen las prácticas recomendadas para probar y migrar tu proyecto con los próximos cambios incompatibles, y cómo proporcionar comentarios a los autores de los cambios incompatibles.
Cómo administrar versiones de Bazel con Bazelisk
Bazelisk te ayuda a administrar las versiones de Bazel.
Bazelisk puede hacer lo siguiente:
- Actualiza Bazel automáticamente a la versión LTS o continua más reciente.
- Compila el proyecto con una versión de Bazel especificada en el archivo .bazelversion. Verifica ese archivo en tu control de versiones para garantizar la reproducibilidad de tus compilaciones.
- Ayuda a migrar tu proyecto para los cambios incompatibles (consulta más arriba)
- Prueba versiones candidatas fácilmente
Proceso de migración recomendado
Dentro de las actualizaciones menores de cualquier versión LTS, cualquier proyecto se puede preparar para la siguiente versión sin romper la compatibilidad con la versión actual. Sin embargo, es posible que haya cambios incompatibles con versiones anteriores entre las versiones principales de LTS.
Sigue este proceso para migrar de una versión principal a otra:
- Lee las notas de la versión para obtener sugerencias sobre cómo migrar a la siguiente versión.
- Los cambios incompatibles principales deben tener una marca
--incompatible_*asociada y un problema de GitHub correspondiente:- La guía de migración está disponible en el problema de GitHub asociado.
- Las herramientas están disponibles para algunos de los cambios incompatibles de migración. Por ejemplo, buildifier.
- Para informar problemas de migración, comenta el problema asociado de GitHub.
Después de la migración, puedes seguir compilando tus proyectos sin preocuparte por la compatibilidad con versiones anteriores hasta la próxima versión principal.