Le BazelCon 2022 se déroulera du 16 au 17 novembre à New York et en ligne.
S'inscrire

Installer / Mettre à jour Bazel avec Bazelisk

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Installer Bazel

Bazelisk est la méthode recommandée pour installer Bazel sous Ubuntu, Windows et macOS. Il télécharge et installe automatiquement la version appropriée de Bazel. Utilisez Bazelisk si vous devez changer de version de Bazel en fonction du répertoire de travail actuel, ou si vous souhaitez toujours mettre à jour Bazel vers la dernière version.

Pour en savoir plus, consultez le fichier README officiel.

Mise à jour de Bazel

Bazel applique une règle de rétrocompatibilité (consultez les conseils pour déployer des modifications incompatibles si vous en êtes l'auteur). Cette page résume les bonnes pratiques à suivre pour tester et migrer votre projet avec les modifications incompatibles à venir, et pour envoyer des commentaires aux auteurs des modifications incompatibles.

Gérer les versions de Bazelisk

Bazelisk vous aide à gérer les versions de Bazel.

Bazelisk peut:

  • Mettre à jour Bazel vers la dernière version LTS ou glissante.
  • Créez le projet avec une version Bazel spécifiée dans le fichier .bazelversion. Enregistrez ce fichier dans le contrôle des versions pour garantir la reproductibilité de vos compilations.
  • Contribuer à la migration de votre projet en cas de modifications incompatibles (voir ci-dessus)
  • Essayez facilement les versions éligibles

Processus de migration recommandé

Dans les mises à jour mineures de n'importe quelle version LTS, n'importe quel projet peut être préparé pour la prochaine version sans rompre la compatibilité avec la version actuelle. Cependant, des modifications incompatibles avec les versions antérieures peuvent se produire entre les versions LTS majeures.

Pour passer d'une version majeure à une autre, procédez comme suit:

  1. Lisez les notes de version pour obtenir des conseils sur la migration vers la version suivante.
  2. Les modifications incompatibles majeures doivent être associées à un indicateur --incompatible_* et à un problème GitHub correspondant :
    • Des conseils de migration sont disponibles dans le problème GitHub associé.
    • Des outils sont disponibles pour certaines migrations incompatibles. Par exemple, buildifier.
    • Signalez les problèmes de migration en commentant le problème GitHub associé.

Après la migration, vous pouvez continuer à créer vos projets sans vous soucier de la rétrocompatibilité, jusqu'à la prochaine version majeure.