Instala 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 para mantener Bazel actualizado a la versión más reciente.
Para obtener más detalles, consulta el archivo README oficial.
Actualizando 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 cambios incompatibles.
Administra versiones de Bazelisk con Bazelisk
Bazelisk te ayuda a administrar las versiones de Bazel.
Bazelisk puede hacer lo siguiente:
- Actualizar Bazel automáticamente a la versión de LTS o progresiva más reciente
- Compila el proyecto con una versión de Bazel especificada en el archivo .bazelversion. Registra ese archivo en tu control de versión para garantizar la reproducibilidad de tus compilaciones.
- Ayuda a migrar tu proyecto para detectar cambios incompatibles (consulta la sección anterior)
- Prueba versiones candidatas fácilmente
Proceso de migración recomendado
Dentro de las actualizaciones menores de cualquier versión de LTS, cualquier proyecto puede prepararse para la próxima versión sin afectar la compatibilidad con la versión actual. Sin embargo, puede haber cambios que generen incompatibilidad 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 consejos sobre cómo migrar a la siguiente versión.
- Los cambios incompatibles importantes deben tener asociada una marca
--incompatible_*
y un problema de GitHub correspondiente:- La guía de migración está disponible en el problema asociado de GitHub.
- Hay herramientas disponibles para la migración de algunos cambios incompatibles. Por ejemplo, buildifier.
- Informa los problemas de migración comentando el problema asociado de GitHub.
Después de la migración, puedes continuar compilando tus proyectos sin preocuparte por la retrocompatibilidad hasta la próxima actualización importante.