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

Contribuer à Bazel

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

Il existe de nombreuses façons d'aider le projet et l'écosystème Bazel.

Envoyer un commentaire

Lorsque vous utilisez Bazel, vous pouvez identifier des points à améliorer. Vous pouvez signaler des problèmes lorsque:

  • Bazel plante ou rencontre un bug qui ne peut être résolu qu'avec bazel clean.
  • La documentation est incomplète ou peu claire. Vous pouvez également signaler des problèmes depuis la page que vous consultez à l'aide du lien "Créer un problème" situé dans l'angle supérieur droit de la page.
  • Un message d'erreur pourrait être amélioré.

Participer à la communauté

Vous pouvez interagir avec la communauté Bazel:

Contribuer au code

Bazel est un projet volumineux. Il peut être difficile de modifier le code source de Bazel.

Vous pouvez contribuer à l'écosystème Bazel de plusieurs façons:

  • Aider les responsables du règlement en leur envoyant des demandes d'extraction
  • Créer des règles et les partager en Open Source
  • Contribuer aux outils associés à Bazel, par exemple les outils de migration
  • Améliorer l'intégration de Bazel à d'autres IDE et outils

Avant d'apporter une modification, créez un problème sur GitHub ou envoyez un e-mail à bazel-dev@.

Les contributions les plus utiles permettent de corriger des bugs ou d'ajouter des fonctionnalités (par opposition aux changements de style, de refactorisation ou de "nettoyage"). Votre modification doit inclure des tests et de la documentation, en gardant à l'esprit la rétrocompatibilité, la portabilité, ainsi que l'impact sur l'utilisation et les performances de la mémoire.

Pour savoir comment envoyer une modification, consultez le processus d'acceptation des correctifs.

Description du code Bazel

Bazel dispose d'un codebase volumineux avec du code dans plusieurs emplacements. Pour en savoir plus, consultez le guide sur le codebase.

Bazel est organisé comme suit:

  • Le code client se trouve dans src/main/cpp et fournit l'interface de ligne de commande.
  • Les tampons de protocole se trouvent dans src/main/protobuf.
  • Le code du serveur se trouve dans src/main/java et src/test/java.
    • Code principal principalement composé de SkyFrame et de certains utilitaires.
    • Les règles intégrées se trouvent dans com.google.devtools.build.lib.rules et dans com.google.devtools.build.lib.bazel.rules. Consultez d'abord les défis liés à l'écriture de règles.
  • Les interfaces natives Java se trouvent dans src/main/native.
  • La liste des outils de compatibilité avec les langages est décrite dans la section Compiler Bazel.

Rechercher le code source de Bazel

Pour effectuer une recherche rapide dans le code source de Bazel, utilisez la recherche Bazel. Vous pouvez parcourir les dépôts, les branches et les fichiers de Bazel. Vous pouvez également afficher l'historique, les différences et les informations de accusation. Pour en savoir plus, consultez le Guide de l'utilisateur de Bazel Code Search.