buck

Utiliser Buck2

Ce repo est mort.

Veuillez consulter https://github.com/facebook/buck2 pour le système de construction qui le remplace.

Le contenu ancien se poursuit ci-dessous à des fins historiques.

---

Mâle

Buck est un outil de construction. Pour voir ce que Buck peut faire pour vous, consultez la documentation sur http://buck.build/.

Installation

Étant donné que Buck est utilisé pour construire Buck, le processus de construction initial implique 2 phases:

1. Clone le référentiel Buck et le bootstrap avec la fourmi:

 git clone --depth 1 https://github.com/facebook/buck.git
cd buck
ant

Vous devez utiliser Java 8 ou 11 pour que cela se compile avec succès. Si vous voyez des erreurs de compilation d'Ant, vérifiez votre JAVA_HOME pointe sur l'une de ces versions.

2. Utilisez la version bootstrapée de Buck pour construire Buck:

 ./bin/buck build --show-output buck
# output will contain something like
# //programs:buck buck-out/gen/programs/buck.pex
buck-out/gen/programs/buck.pex --help

Binaires de mâles préconçus

Les binaires pré-construits de Buck pour n'importe quel Buck sha peuvent être téléchargés à partir de https://jitpack.io/com/github/facebook/buck/<sha>/buck-<sha>.pex <sha>/buck-<sha>.pex. La toute première fois qu'une version de Buck est demandée, elle est construite via Jitpack. En conséquence, il pourrait prendre quelques minutes pour que ce binaire initial soit disponible. Chaque demande ultérieure ne servira que directement l'artefact construit. Cette fonctionnalité est également disponible pour n'importe quelle fourche de mâle, vous pouvez donc récupérer https://jitpack.io/com/github/<github-user-or-org>/buck/<sha>/buck-<sha>.pex

Pour les binaires Buck construits pour JDK 11, modifiez l'extrémité de l'URL à buck-<sha>-java11.pex .

Dépréciation des fonctionnalités

Buck essaie de se déplacer rapidement par rapport à ses internes. Cependant, pour les fonctionnalités portées face aux utilisateurs (règles de construction, interface de ligne de commande, etc.), l'équipe Buck essaie d'avoir un processus de dépréciation gracieux. Notez que cela s'applique généralement uniquement aux fonctionnalités documentées ou aux fonctionnalités moins documentées, mais qui semble être largement utilisée. Ce processus est:

• Un problème est ouvert sur GitHub suggérant ce qui sera obsolète et lorsqu'il sera supprimé. Pour les fonctionnalités plus grandes qui sont obsolètes, il peut y avoir une période où la valeur par défaut est le nouveau paramètre, et l'ancien comportement ne peut être utilisé qu'avec un changement de configuration.
  • Les problèmes de dépréciation en cours sont étiquetés par «annonce» et «dépréciation»
• Un changement est soumis à Buck qui met l'ancien comportement derrière un indicateur de configuration et définit la valeur par défaut vers l'ancien comportement. Ces drapeaux se trouvent sur https://buck.build/concept/buckconfig.html#incompatible.
• Pour les fonctionnalités plus grandes, un changement est finalement mis en place qui définit la valeur par défaut au nouveau comportement. Par exemple, lorsque Skylark devient l'analyseur de fichiers de construction par défaut.
• Lorsque la date de suppression est atteinte, une modification est soumise pour supprimer la fonctionnalité. À ce stade, la valeur de configuration analyse toujours, mais ne sera pas utilisée par Buck en interne.

Licence

Licence Apache 2.0